Skip to main content

§ masterplan.md

Glass Meditation App

A calming glassmorphism meditation app with breathing circles, ambient soundscapes and session streaks.

All ideas
Glassmorphism

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)

  1. 01 PUBLIC Home — Today's suggestion and quick start.
  2. 02 PUBLIC Sessions — Library with filters.
  3. 03 PUBLIC Breathe — Breathing visualiser and patterns.
  4. 04 PUBLIC Progress — Minutes practised and mood trends.
  5. 05 APP (signed in) Profile — Preferences, downloads, account.
  6. 06 AUTH Sign up — Create an account with email or a social provider.
  7. 07 AUTH Log in — Return to the account, with error and lockout states.
  8. 08 AUTH Reset password — Request a reset link and set a new password.
  9. 09 APP (signed in) Account settings — Profile, email, password, language and delete account.
  10. 10 PUBLIC Contact — Contact form plus real address, phone and email.
  11. 11 LEGAL & SYSTEM Privacy policy — What data is collected, why, and how to remove it.
  12. 12 LEGAL & SYSTEM Terms of service — Rules of use, liability and account termination.
  13. 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