+50 XP · Streak: 1

Phase Complete

Three slow breaths. In as the orb expands. Out as it contracts. Collect the reward.

"What you do in anything is how you do everything."
🔥 1 session streak
Ambient ⏸
⚠

Session in progress

You have an open session in progress. Leaving will not erase your entries, but your timer and step position will be lost.

Return to yourself

Six protocols for when your system needs to come back online

⚡
Before you beginFollow the orb. Breathe in as it expands, out as it contracts. Nothing to fix yet.
ZenQi Activator

You are built for output. This is your moment.

Your ZenQi Archetype

Suggested for Restore

◈
Based on your pattern

Where are you right now

Music
Micro-task
Environment
Body reset
Reward
Your ZenQi Archetype

Suggested for Activator

◈
Based on your pattern

Choose your activation state

Music
Micro-task
Environment
Body charge
Reward

Analytics

Usage patterns across Restore & Activator · Scaffolded for multi-user accounts

Z

Guest User

Data stored locally · Login to sync across devices

Your ZenQi Archetype

—

Sessions over time

Top Restore States

Top Activator States

Local data: zenqi_analytics_v1 · zenqi_sessions_v1 · zenqi_settings_v1 · zenqi_user_v1. When logged in, data syncs to your account via Netlify Blobs and restores on any device.

Feature Roadmap Beta

All planned, active, and released features across ZenQi modules · Click any feature to expand brainstorm notes

Feature Status Version Module
Loading roadmap…
Released
Dual-mode architecture
Restore Navigator + Activator as unified app with mode toggle
Six Restore states and six Activator states. Single pill toggle switches entire UI including background, orb, colour accent, and content. State grid animates in/out. Foundation for all future module expansion.
 Released β 0.1 Core · All modules
Protocol panels — 3-phase step system
Phase tabs, step pips, auto-advance, completion tracking
Each state has 3 phases × 3–4 steps. Steps auto-activate in sequence. Phase transition banners fire on completion. Phase pips (grey/gold/green) give visual progress. Step counter X/Y live-updates. Foundation for all protocol delivery.
 Released β 0.1 Restore · Activator
Timer system with auto-complete
Per-step countdown bar, urgent state at 20%, chime + grace period
Each step has an optional duration. Timer drains a progress bar, turns red at 20% remaining, plays a chime at zero, auto-completes after 1.5s grace. Manual "Complete ✓" button skips early. Web Audio API chime — no external dependencies.
 Released β 0.1 All protocols
Guided input fields
Single, dual-column, and list-type input fields per step with autosave
40 steps classified across both modules with field types: single textarea, dual-column (colA/colB), and numbered list inputs. Debounced autosave to localStorage. Session schema versioned under zenqi_sessions_v1. Future-proofed for archetype engine.
 Released β 0.1 All protocols
Reward system — XP + streak + confetti
Phase 3 completion reward, XP accumulation, day streak, session summary
+100 XP base, +10 per streak day. Ascending chime via Web Audio. Confetti burst (warm palette for Restore, gold for Activator). Breathing orb ritual. Randomised completion title + quote. Session summary cards show input data per step. After reward: returns to module selector.
 Released β 0.1 All protocols
Ambient music — YouTube IFrame API
Auto-play ambient audio, pause/play bar, volume management
Single YouTube video ID drives ambient music. Music bar bottom-right with breathing orb indicator. Auto-plays on load. Settings module scaffolds multi-track shuffle per module (Restore / Activator) for future implementation.
 Released β 0.1 Global
Analytics — session tracking + chart
Bar chart by Day/Week/Month/Year, top states ranking, XP/streak stats
Events namespaced under zenqi_analytics_v1. Tracks panel opens, step starts/completes, phase completions. Chart ordering: Day 00–23, Week Mon–Sun, Month 1–31, Year Jan–Dec. Top states ranked per module. Scaffolded for server sync and multi-user admin view.
 Released β 0.2 Analytics
Activator ember background
60-particle canvas, mouse-reactive radial gradient, transitions in/out
Canvas-based rising ember particles in warm orange/amber hsl range. Radial gradient shifts toward mouse position. Fades in/out with 1.2s CSS transition on mode switch. Resize-safe: listener re-sizes canvas without resetting context.
 Released β 0.1 Activator
Restore rain background
180-drop canvas rain in indigo/blue, gentle falling angle, fog gradient
Canvas-based rain with 180 drops at varying speed, width, and alpha. Indigo fog gradient base layer. Slight rightward drift matches natural rain fall angle. Starts on load (Restore default), stops on Activator switch, restarts on return. Resize-safe.
 Released β 0.3 Restore
In-progress session guard
Modal prompt when navigating away from active session mid-protocol
Triggers on cross-panel or cross-mode navigation when steps are completed. Free to peek at phase tabs within the same panel. Two options: Return to session / Leave & continue. On leave: active timers cleared, entries preserved in localStorage.
 Released β 0.3 All protocols
Meditative quote engine — Phase 2 & 3
Slow fade-in/out quote rotation replaces Quick Shifts on execution phases
Phase 1 retains Quick Shifts for orientation. Phase 2 and 3 show a quote panel with 10 curated quotes per module, cycling every 7s with 600ms fade transition. Quotes are different for Restore vs Activator. Custom quote injection from Settings extends the pool at runtime.
 Released β 0.3 All protocols
Settings module — music + quote library
YouTube track slots per module, custom quote input, local save
Three music slot inputs per module (Restore / Activator). Two quote textareas (one per module, one quote per line). Save writes to zenqi_settings_v1 and injects custom quotes into the live pool immediately. Admin expansion point for future protocol-specific customisation.
 Released β 0.3 Settings
User context scaffold — analytics identity
Guest user display name, avatar initial, local identity key
User identity stored under zenqi_user_v1. Display name editable via prompt. Avatar shows first initial. Scaffolded for login-based multi-user isolation — all analytics data is currently per-device local. Server deployment will filter analytics by user ID from this key.
 Released β 0.4 Analytics
Planned — Next Release
Multi-track ambient shuffle
Rotate between 2–3 saved YouTube IDs per module automatically
Settings already scaffolds 3 slots per module. On track end, picks next from saved IDs at random (avoiding immediate repeat). Mode-aware: reads Restore vs Activator pool based on current body class. Falls back to default loop if no tracks saved.
 Released β 0.5 Settings · Music
Protocol-specific quotes per state
Quote pool differentiated by state (e.g. Shutdown quotes vs Hyperfocus quotes)
STATE_QUOTES object: 10 quotes per state across all 13 states (6 Restore + 6 Activator + Coffee Crew). Each pool tone-matched to the emotional register of the protocol. startExecQuotes() reads STATE_QUOTES[stateKey] with fallback to module pool. Module-level pools remain as safety net.
 Released β 0.5 All protocols
Archetype classification engine
6 archetypes derived from usage frequency and session patterns
Archetypes: Executor · Regulator · Synthesiser · Initiator · Reflector · Responder. Scored from stateCounts, module split, and usage patterns. classifyArchetype() requires 5+ sessions. Archetype card rendered in Analytics above stats grid. Each archetype carries a suggest{} object used by the suggestion engine.
 Released β 0.6 Analytics · Protocols
Suggestion engine — "Based on your pattern"
Surface recommended states and protocols from usage data
Reads archetype from classifyArchetype(), calls getSuggestion(arch, mode) to get a state key + reason. Rendered as a subtle dismissible banner above the state grid for the active mode. Shown on load (Restore) and on mode switch. Dismissed per-session via sessionStorage. Requires 5+ sessions minimum.
 Released β 0.6 Analytics · Landing
Future — Roadmap
Login + multi-user sync
Authentication layer, per-user data isolation, cross-device sync
Local schema (zenqi_user_v1, zenqi_analytics_v1, zenqi_sessions_v1, zenqi_settings_v1) is pre-namespaced for server sync. Login: email/magic link preferred (frictionless, no password friction for neurodivergent UX). All analytics data filtered by user ID from zenqi_user_v1. Admin view would show aggregate patterns across users.
 Future v1.0 Global · Backend
Admin dashboard — multi-user analytics
Aggregate view across all users, state frequency heatmaps, cohort analysis
Analytics page already has the scaffold. Admin mode would show: total active users, most-used states globally, session time distribution, archetype distribution across user base. Useful for understanding community-wide patterns. Privacy: no PII exposed — only aggregated usage data.
 Future v1.0 Analytics · Admin
Archetype dashboard — personalised home
Archetype card, pattern history, suggested protocols, streak insights
Landing page evolves from a static state grid to a personalised dashboard for returning users. Shows: current archetype with description, recent session history, pattern insights ("You tend to crash on Wednesday afternoons"), and a smart protocol suggestion. New users still see the clean static grid. Dashboard unlocks after 10 sessions.
 Future v1.1 Landing · Analytics
ZenQi mobile app (PWA)
Progressive Web App — installable, offline-capable, push notifications
Current single-file HTML is already mobile-responsive. PWA upgrade: service worker for offline, manifest for home screen install, push notification for streak reminders ("You haven't reset today — your streak is at risk"). Notification UX must be opt-in and respectful — no guilt mechanics, just gentle nudges.
 Future v1.2 Global · Mobile
Custom protocol builder
User-defined states with custom phases, steps, timers, and quote pools
Power-user feature. Drag-and-drop phase/step builder. Each step configurable: title, detail, duration, input field type. Phase name + anchor quote editable. Custom state appears in the selector grid alongside built-in states, differentiated with a custom icon. Export/import as JSON for sharing protocols.
 Future v1.3 Restore · Activator
Ignite Within integration
Faceless media channel: motivational quotes paired with landscape photography + ambient music
Conceptual bridge between ZenQi app and the Ignite Within content channel. ZenQi could surface "Today's Ignite" — a daily quote + image pair from the channel. Crossover content strategy: ZenQi drives awareness, Ignite Within drives depth. Shared aesthetic: dark, calm, intentional. Photography sourced from your own landscape work.
 Future v2.0 Content · Brand

Version numbering follows β (beta) 0.x → v1.x (post-login) convention. Current build: —. All items marked Planned are scoped and implementation-ready. Items marked Future are brainstormed and directionally committed but not yet scoped. Schema: zenqi_roadmap_v1

Statistics Admin

Anonymous aggregate usage across all logged-in users ·

Loading statistics…

All data is anonymous — no emails, names, or user IDs are returned. Aggregation happens server-side in zenqi-stats Function.

Settings

Customise your ZenQi experience · Future: admin-controlled per module

Restore Mode — Ambient Music Scaffolded

Music Sources (YouTube IDs or URLs)

Add up to 3 tracks for Restore mode. ZenQi will shuffle between them to match the depth of each protocol. Format: YouTube video ID (e.g. 3drza3ZbsC0)

1
2
3

Activator Mode — Ambient Music Scaffolded

Music Sources (YouTube IDs or URLs)

Add up to 3 tracks for Activator mode. High-energy or binaural — suited to sprint and focus states.

1
2
3

Motivational Quote Library Scaffolded

Restore Mode Quotes

One quote per line. These will appear as meditative prompts during Phase 2 & 3 execution steps in Restore protocols.

Activator Mode Quotes

One quote per line. These will rotate in the breath bar and meditative panels during active execution phases.

✓ Saved

Settings are stored locally on this device. Admin customisation — future versions will allow protocol-specific music and archetype-matched quote libraries. Schema: zenqi_settings_v1