§ masterplan.md
Glass Meditation App
A calming glassmorphism meditation app with breathing circles, ambient soundscapes and session streaks.
01
App overview and objectives
A calm, translucent space for guided meditation and breathing: sessions by length and goal, a breathing visualiser, ambient soundscapes and a gentle streak that never shames you.
02
The problem worth solving
Most wellness apps use the same engagement tactics that cause the stress they claim to treat. Removing streak guilt and notification pressure is the actual product differentiator.
03
Target audience
- Primary — Beginners who want short, guided practice without a subscription trap.
- Secondary — Experienced practitioners wanting a timer with ambient sound.
04
Roles and permissions
- Visitor — read-only public pages, can sign up.
- Member — owns their own records, cannot see other users' data.
05
Core features
- Session library filtered by duration, goal and teacher
- Breathing visualiser with configurable patterns
- Mixable ambient soundscapes
- Unguided timer with interval bells
- Gentle progress: total minutes, no punishing streak counter
- Offline download of favourite sessions
Deliberately later
- Sleep stories
- Courses spanning several days
- Teacher publishing portal
06
Technical stack
React with the Web Audio API for mixing, audio hosted on a CDN, minimal account storing only progress.
Why: Web Audio allows layering voice and ambience with independent volumes without preparing every combination as a file.
Alternatives: Native apps (better background audio, two more codebases) or a simple audio player (trivial, loses the mixing feature).
07
Conceptual data model
Session — title, teacher, goal, duration, audio file, transcript
Soundscape — name, loop file, default volume
Practice — user, session, duration completed, mood before and after, date
BreathPattern — name, inhale, hold, exhale, hold, cycles
Preference — reminder time, default duration, sound mix
08
Integrations
- Audio CDN
- Payments if a paid tier exists
- Optional health platform export
09
UI design principles
- Frosted translucent panels over a soft gradient or blurred photographic backdrop.
- Depth through blur and light borders rather than drop shadows.
- Check contrast on every glass surface; text stays readable over any background.
10
Security considerations
- Mood entries are sensitive personal data: encrypted, private by default, exportable and deletable.
- No third-party analytics inside a session screen.
- Reminders are opt-in with a single tap to stop, permanently.
11
Development phases
Phase 1 — Prove the core
- — Session library filtered by duration, goal and teacher
- — Breathing visualiser with configurable patterns
- — Mixable ambient soundscapes
- — Static content and design system in place
- — Basic analytics
Phase 2 — Make it real
- — Unguided timer with interval bells
- — Gentle progress: total minutes, no punishing streak counter
- — Offline download of favourite sessions
- — Accounts, sign-in and password reset
- — Empty, loading and error states everywhere
Phase 3 — Polish and launch
- — Performance, accessibility and SEO pass
- — Legal pages, contact route and 404 handling
- — Wire up: Audio CDN
- — Wire up: Payments if a paid tier exists
Phase 4 — Grow
- — Sleep stories
- — Courses spanning several days
- — Teacher publishing portal
12
Challenges and solutions
Risk — Audio stops when the screen locks on mobile web
Solution — Use the media session API and clearly recommend the installable app experience for long sessions.
Risk — Content production cost
Solution — Launch with a small excellent library and a teacher revenue share rather than a large mediocre one.
Risk — Engagement tactics conflict with the mission
Solution — Measure success as minutes practised, not daily opens; make reminders gentle and easy to disable.
13
Future expansion
- Corporate wellbeing plans
- Regional-language teachers
- Therapist referral partnerships
14
Page list (13 pages)
- 01 PUBLIC Home — Today's suggestion and quick start.
- 02 PUBLIC Sessions — Library with filters.
- 03 PUBLIC Breathe — Breathing visualiser and patterns.
- 04 PUBLIC Progress — Minutes practised and mood trends.
- 05 APP (signed in) Profile — Preferences, downloads, account.
- 06 AUTH Sign up — Create an account with email or a social provider.
- 07 AUTH Log in — Return to the account, with error and lockout states.
- 08 AUTH Reset password — Request a reset link and set a new password.
- 09 APP (signed in) Account settings — Profile, email, password, language and delete account.
- 10 PUBLIC Contact — Contact form plus real address, phone and email.
- 11 LEGAL & SYSTEM Privacy policy — What data is collected, why, and how to remove it.
- 12 LEGAL & SYSTEM Terms of service — Rules of use, liability and account termination.
- 13 LEGAL & SYSTEM 404 not found — Friendly dead end with search and links back.
15
Page map
PUBLIC AUTH APP (signed in) LEGAL & SYSTEM ─────────── ───────────────── ─────────────────── ─────────────────── ├─ Home ├─ Sign up ├─ Profile ├─ Privacy policy ├─ Sessions ├─ Log in └─ Account settings ├─ Terms of service ├─ Breathe └─ Reset password └─ 404 not found ├─ Progress └─ Contact key flows: Home ──▶ Sessions Home ──▶ Breathe Sessions ──▶ Progress Profile ──▶ Sessions
