Roadmap & Task List

Living list of what's planned and what's done. Ask in chat to add or tick items.

Single source of truth for what's planned. Update this file instead of re-listing tasks in chat.

Status legend: [ ] not started · [~] in progress · [x] done

✅ Recently completed

Practice & flows

Full mantra text, translation and description in session cards without clipping; landscape headers no longer cover long mantra titles.
One repetition-choice standard everywhere: 11 / 21 / 27 / 54 / 108 (plus 1 and 3 for short mantras, 1008 where fitting).
Sankalpa intention picker in game flows, same treatment as chant flows.
Lifetime recitation counter per mantra; retreat-style milestone badges earned only from logged practice.
Private reflection note after a completed practice; dedication of merit on combined, game-flow and hands-free completion screens.
Unified Practice settings sheet (Eco mode, mala beads, bead sound, vibration, heart-offering frequency) shared by hands-free setup and active recitation, synced across tabs.
Heart-offering meditation with three modes (after each recitation / end of flow only / off); seated-practitioner backdrop with the deity resting at the heart and mantras flowing into it.
Natural-language practice builder ("2 hour practice, deities of the day, protective focus, full malas") with review step and bounded duration.
Deity-element glow themes / chakra colour accents, and Eco battery-saver display mode.
AI guide in the cosmic companion: panchang-aware, saved-flow aware, one-tap recommendations.

Companion & music

Cosmic phone wallpaper beta in Cosmic Insight and Profile settings: local 1440 × 2560 PNG using the app's planet artwork and neon hora dial, actual lunar illumination and tithi patron, day deity, zodiac wheel, natal patterns and exact-moment transit contacts with colour-coded qualities.
Movable frosted-glass cosmic companion; chant/game/music controls live inside it; "Both" renamed "Chant + Game".
40-track Suno mantra catalogue with weekday/deity recommendations, search, and one-tap daily Music start.
Full-page Music Flow builder matching Game Flow (presets, quick counts, auto-start, intentions, saved flows, deity grid); persistent mini-player across navigation; automatic track advance with progress bar and repeat modes.

Games & multiplayer

Game-flow polish: uninterrupted endings with a 0–30 s pause, exact planned levels preserved, exact offerings, repetition maths fixed (one chosen repetition = one complete mantra), phrase-aware line breaking.
Game-flow ending returns the exact mantra text and exact completed counts into the deity-in-heart offering.
1-vs-1 shared practice on one sideways map with gold/violet lanes, live progress and actual-completion receipts; one shared round clock, 3 s refresh, instant local taps.
Multiplayer lobby corrections: self-removal of picks, time-share enforcement, mutual approval before begin.
Personal practice backdrops (own photo, zoom-out, person cut-out) behind deity games; gold top-navigation light wave.
Shared fallback game engine powering all 18 deities; game-play polish 1–4 done.

Content

Verified texts imported from the reviewed workbook for Ganesha, Shiva and Annapurna (stotras + Level 4 mantras).
Content review Excel export (3,908 rows) and the populated ChalisaVibe-catalog workbook with compact notes.
Supplied content added for Surya, Shani, Bhairav, Durga, Parvati, Ganga, Dhanvantari, Kuber (six L4 mantras each, aarti, bonus levels).
Custom game flows at /games/flow with builder, auto-advance and receipt; practice-together lobby and shared sessions.

🔨 Active priorities

[~] Cosmic companion / Whisperflow-style shortcut: floating ChalisaVibe logo follows the current planetary hour, softly alternates with the favourable deity, opens 5/10/20-minute Chant, Game, or Chant + Game quick sessions, and can be turned off in Profile settings. Downloadable wallpaper beta is done; background alerts and an automatically changing live wallpaper remain.
[~] Verified workbook import — continue importing the Claude-reviewed texts from the ChalisaVibe-catalog workbook into the app. Done: Ganesha, Shiva, Annapurna (stotras + Level 4 mantras). Remaining: the other 16 deities, chalisas and aartis as the review completes.
[ ] Calendar-style badge grid — restructure the badges/milestones display into the calendar's collapsible-section layout (open/close segments that persist), so retreat milestones stay browsable without clutter.
[ ] Background music in hands-free practice.
[ ] More mantras for thin deities — Saraswati first.
[ ] Per-name English meanings in Level 2 (name list) and Level 3 (108 names) of every deity game — Shani's level 2 is the standard. Needs meaning strings in the src/data/*-names.ts files plus the falling-pill UI showing the meaning under the transliteration.
[ ] Annapurna game route — content is live in chants + hands-free but there is no games.annapurna route yet.
[ ] Wire 108-name Level 3 for bhairav, dhanvantari, ganga (name files exist); add the nine Graha Gāyatrīs to the chant library / hands-free "Other texts".
[ ] Navagraha L2 (weekdays) vs L3 (bījas) feel similar — consider merging and adding a distinct level.

🌱 Long-term ideas

Hosted audio & lockscreen controls

Listen mode for every chalisa: ~3 audio variations per chalisa (slow learning pace, traditional rendition, fast/flow japa pace) played from self-hosted audio files in Cloud storage with the native <audio> element — full playback for everyone, unlike embeds.
Mantra audio: each core mantra gets at least one clean loopable recitation, ideally 2–3 tempos.
Practice beats / background music: tanpura drone, soft mridangam/tabla cycles, ambient temple bells, silence-friendly low drone; independent volume so voice + beat mix, beat keeps playing across screens.
Sourcing: prefer licensed/original recordings by a real reciter (authenticity matters); store as audio assets + metadata (deity slug, variant, tempo, duration, reciter, license).
Acceptance bar: audio must never feel synthetic or disrespectful; wrong pronunciation is worse than no audio.

Pronunciation audio guide per mantra

Tap-to-hear pronunciation for every mantra line, tied to the existing pronunciation-guide toggle in the reader.

Deity game variations & rebuilds

Rebuild the bespoke per-deity games: the original game code is preserved in src/game-templates/<slug>.game.tsx.txt (plus game-catalog.original.ts.txt). Restore one at a time, level design intact, when credits allow.
Learn-it-for-life pass (all 19 games + chalisa game): every mantra/name/verse riding a drop carries a short plain-English meaning (line-by-line glossary like Shani L2/L4/L5), so knowledge is retained outside the app.
Adaptive catch zones that breathe with combo, boons and lives in every game (done for Shani).
Shared audio layer for all games (Web Audio API): consistent background beat, spawn chime, capture tone, level-complete sound, optional voice hint; easy mute/volume/beat-pick. Sound should support meditation, not add stress.
Recitation flow is the core quality bar: how a mantra rides in, is held, fills, and resolves must feel meditative — steady cadence, eased motion, forgiving capture — in every game's own mechanic.
Completion gating audit: no level completes before its artifact minimums; re-check queue levels beyond Shani L3.
Match Hanuman's depth everywhere: bonus stotras/kavachs where they exist, Aarti toggle on the Chalisa level, line-by-line meanings for the extra content.

Web push astrology notifications

Hourly-precision phone notifications when the sky touches the user's natal chart, with a one-tap "recite now" deep link.
Scan engine: extend src/lib/transit-events.ts with transitPeaksForWindow(from, to, birth) sampling every ~10 min for exact-orb peaks.
Alert rules: fire ~15 min before peak; filter by strength; cap per day; respect quiet hours in use-notifications.ts.
Deity routing: peak planet → DEITY_PLANET → chalisa; multi-planet peaks → Navagraha.
Delivery: phase 1 = local scheduling in the notification service worker; phase 2 = real Web Push subscription in Cloud + a cron /api/public/* route computing peaks per subscriber.
Prefs: "Moon aspects (hourly)", "Slow-planet peaks", "Lead time 5/15/30 min", "Min strength".

Native companion packaging (always-on floating app)

Package a native app with a Whisper Flow-style always-on companion that floats above the phone home screen and other apps (platform overlay permissions; not possible from the website alone).
Personal to the user's birth chart + live transits; changes through the day with the planetary hour (hora) and the deities of the day.
Small floating button → one-tap quick game or recitation matched to the current hour; alerts when a good recitation window opens (reuse cosmic-timing, power-windows, transit-events, notifications).
User picks a time amount (e.g. 5 min) → auto-builds the session via existing quick-play / flow builders.
Phone = installable app + notifications; laptop = small always-on-top window/widget. Also covers the background live-wallpaper-style screen tinted by the hora.

Also on the horizon

Hindi / Devanagari app language — full UI toggle (English ⇄ हिन्दी) in Profile → Settings, translation dictionary src/i18n/hi.ts, Hindi mode defaulting to Devanagari + Hindi meaning. For users who want to practise entirely in Hindi.
Voice command layer — "bring forth the Lakshmi Chalisa", "start 108 of the Gayatri mantra", "what is good today?" → intent parse → navigate + start. Web Speech API or speech-to-text via the AI gateway, reusing the intent-parser.functions.ts pattern.
Voice-followed auto-scroll (revisit) — the previous attempt scrolled jerkily and was removed. Rebuild only when smooth: continuous recognition → fuzzy-match the spoken line → eased advance, never jump backwards. Acceptance: recite a full chalisa without touching the screen.
Deeper mantra statistics — per-mantra streaks, intention tags on lists, month view, export (japa totals, malas, 7-day bars, top deity already done).
Car-screen mode (investigation) — Tesla browser works parked today (QR code, no store); Android Automotive needs a packaged app (phase 2); Skoda/VW MIB3 closed; CarPlay/Android Auto audio-only. Build order: /car landscape route (Recite/Chant/Play) → hot-seat multiplayer → audio media mode → packaged build. Driver interaction stays audio-only.
Deity roster expansion — evaluate candidates (Venkateshwara, Sai Baba, Khatu Shyam, Vishnu, Narasimha, Tulsi, Santoshi Mata, Mahalakshmi, …) against the inclusion rules: authentic respectful sources, calm tone, enough core-spine content, existing daily practice. Output: docs/deity-roster.md.
Chalisa quality & multi-language — keep translations literal and respectful; fix reported verses first (Durga v3, Shiva v4/v27, Radha v8, Annapurna, Dhanvantari v5); structure data so more languages add cleanly.
Build library (F2) — the reusable level/tool module catalogue lives in docs/level-blueprints.md, content schema in docs/deity-content-template.md, per-level amounts in docs/game-content-spec.md. Goal: any remix (deity game, Brand Arcade, other course) = content file + list of build ids, no gameplay code. Content is written outside Lovable against the schema; batch deities 2–3 per message; offline bonus-text audit (F4) feeds level ids.
Project Sanctuary — spatial sadhana dome & smart artifacts (long-term hardware concept): ceiling-projected mantra canopy with live recitation HUD, collectible sacred artifacts (RFID/motion) unlocking deity environments, passive sadhana mode and spatial room gameplay. Software-first steps: "Room mode" ultra-large-type cast view of the teleprompter/auto-mala, Chromecast/AirPlay support, NFC tags launching deity flows. Expanded vision: living-room 1-vs-1 radial split-arena duel, 5-colour classroom team arena with a collective "Maha Sankalpa" goal, and a 6-minute secular-toggletable "Mindful Focus Reset" for study blocks.

💼 Business & growth

Positioning. ChalisaVibe is a friendly, daily-use companion for people who already want to chant, read a chalisa, or check what is auspicious today — not the biggest Hindu app. Usefulness and respectful accuracy: good English translations, clear structure, calm phone-first experience.

What makes it different

Hands-free recitation that actually counts — flow builder mixes mantras and chalisas in any order; teleprompter paces line by line, keeps the screen awake, logs the session; optional AI-assisted ear mode listens for Sanskrit and advances the mala.
Practice, not just playback — mala counter, mantra builds, hands-free flow built for active recitation; favourites, stats, streaks, weekly recap.
Games that teach the content — arcade levels are memorisation devices; structured level spine per deity with line-by-line meaning support and optional sankalpa.
A calendar tied to real local time — panchang with location and sunrise-to-sunrise boundaries; intent planner rates a specific day across eight themes with peak windows.
Personalisation without overwhelm — favourites, saved flows, avatar frames adjust the app while the structure stays step-by-step and modular.
Respect-first content — literal, plain-English translations; calm devotional visual tone usable in public or family settings.

Honest framing for partners: it does not replace a priest or scripture; the moat is the integration of accurate content + voice-aware practice + playable memorisation + a sunrise calendar. New deities, languages and remixes plug into the same reusable builds.

Partnerships & user acquisition — reach out to creators/teachers/communities in the bhakti/yoga/wellness space; a clear one-pager per partner; tracked partner links; keep promotion respectful, no guaranteed spiritual claims.

Brand Arcade — business templates program (deferred until a client is paying)

Paused for cost reasons; design notes in docs/brand-arcade.md, playbook in docs/brand-arcade-playbook.md.

Playbook + config tool (next concrete step): intake form + Gemini prompts for all copy/config; first build a /brands/new client-side form on top of the existing buildLadder() maths.
Finished vertical templates per vertical (CBD/cosmetics, water/home, sports nutrition): onboarding = copy template + fill one config file; each brand's design.prompt mirrors the client's real website.
Campaign cycles tied to discount periods: start/end dates, own reward ladder + giveaway pool, themed visuals, leaderboard reset; auto-switches by date.
Giveaway engine: cycle-end draw for top players/code holders, pre-checked against the CAC guardrail; the retention hook.
Pricing model: one-time setup fee + monthly subscription (hosting, leaderboard, campaigns, updates, analytics).
Deployment options: 1) standalone white-label app + custom domain (premium tier), 2) embeddable widget/script (fastest proof — go-to-market order starts here), 3) platform integrations (Shopify/WooCommerce — only at demand).
Maintenance model, three stages: prompt library → self-serve admin (products/phrases/dates in DB + validated form) → multi-tenant SaaS (per-brand logins, RLS, billing, product sync), built only as revenue justifies.

India customer-retention subscription (ChalisaVibe × Brand Arcade)

Offer Indian businesses devotional daily practice as a customer-retention channel: white-label or co-branded daily deity focus, recommended chalisas/mantras, mini-games, sacred-calendar feed.
Retention mechanics: daily deity check-ins, streaks, 108-recitation milestones, avatar frames, weekly recap, festival notifications tied to the business's campaigns.
Business models to explore: SaaS per location/store, per-active-user fee, or bundled with Brand Arcade campaigns as the off-season retention engine.
First validation step: pick 3–5 verticals (wellness, food/grocery, fitness, education, retail) and draft a one-page offer before building tooling.
Open question: separate app/brand, or a configurable skin of ChalisaVibe?