Meditation

UI Design Proposal — Guided Meditation, Daily Schedule & AI-Powered Mindfulness
Guided Meditations Daily Schedule Media Categories AI Assistant Meditation Player Personalized Tags
UI / UX Specification May 2026 English Edition v1
Section 1 — Design Principles & Color System
Design System

Design Foundation

Meditation uses a deep midnight navy base derived directly from the brand design files — a calm, immersive dark environment that disappears into the background and lets the content breathe. A single teal (#2EC4B6) accent carries action and life. AI surfaces retain their distinct purple to stay recognizable at a glance.

The platform integrates cutting-edge therapeutic methodologies drawn from three traditions: the contemplative wisdom of Tibetan Buddhism and Eastern philosophy, the somatic and mindfulness-based approaches of modern Western psychology, and the structured frameworks of European and American psychoanalysis. This fusion ensures every session is grounded in both ancient inner science and evidence-based clinical practice.

Midnight Base

Deep #1A1A2E background creates an immersive nighttime feel — ideal for bedtime and focus sessions. Low blue-light emission supports healthy melatonin cycles.

Teal Accent — One Tone

#2EC4B6 — the single action color. Calm and focused, not stimulating. Used only for interactive elements, progress, and confirmation states.

Breathable Space

Generous padding and subtle card borders. The interface should feel as quiet as the content. No visual noise, no competing signals.

AI — Purple Zone

All AI surfaces retain purple gradient. The AI assistant is a distinct, intelligent layer — visually separated from the meditation content itself.

Time-Aware Palette

Morning slots use warm amber tones, afternoon uses teal (default), evening uses soft purple. The interface reflects the time of day naturally.

Mobile First

Touch-optimized controls, minimum 44px tap targets, thumb-reachable media player controls. The app lives on the phone, used in bed, on a mat, in quiet spaces.


Color System

Dark Base

Night Deep
#0D0D1A
Night
#1A1A2E
Surface
#16213E
Card
#0F3460

Accent & State

Teal
#2EC4B6
Morning
#F59E0B
AI
#7C3AED
Text
#E9F4F2
Typography: System sans-serif (SF Pro / Helvetica Neue). Bold 700 for headings and labels, medium 500 for navigation, regular 400 for body text. Letter-spacing: tight (-0.5px) on headings, loose (1.5px) on uppercase labels. Font size minimum 12px in all UI components.
Section 2 — Product Vision & User Profiles
Product Vision

Meditation — Three Core Pillars

Meditation is a structured, personalized mindfulness platform. Users discover curated audio and video meditation content organized by categories and tags, build a daily three-session practice schedule, and receive AI-powered guidance to find and generate new meditations suited to their current state of mind.

Guided Meditations

A curated library of audio and video sessions organized into categories. Each category carries media tags — the user's personal filter for their daily schedule.

Daily Schedule

Three configurable time slots — Morning, Afternoon, Evening — each linked to a preferred media tag. The server auto-assigns matching meditations at the right time of day.

AI Assistant

An always-available AI companion that recommends meditations from the library, generates new personalized sessions, and explains techniques based on the user's history and mood.


Target User Profiles

1. The Morning Practitioner

Age: 28–45, health-conscious professional

Starts every day with a 10–15 min morning meditation before work. Values consistency and a clean, distraction-free interface that loads fast and plays immediately.

Key need: reliable morning schedule, quick-play, no friction.

2. The Stress Manager

Age: 30–55, high-load work environment

Uses meditation reactively during stressful workdays. Wants a "Stress Relief" category always one tap away, short sessions (5–10 min) with breathing exercises.

Key need: fast access to stress/anxiety category, short formats.

3. The Sleep Seeker

Age: 22–50, sleep quality issues

Uses guided sleep meditations nightly. Needs a dark-adapted interface, a gentle timer, auto-stop after session ends, and evening schedule pre-loaded with Sleep content.

Key need: sleep timer, auto-stop, dark comfort UI, evening slot.

4. The Mindfulness Explorer

Age: 18–35, curious and variety-seeking

Wants to try new techniques — body scan, visualization, mantra, nature sounds. Relies on the AI assistant to surface fresh content and explain unfamiliar practices.

Key need: AI recommendations, diverse library, tag browsing.


User Journey — First 7 Days

Day 1

Download, Splash, Onboarding, Register / Sign In

Day 1

Set 3 schedule slots, pick media tags per slot

Day 1–2

First scheduled meditation, explore categories

Day 3

AI suggests personalized session based on usage

Day 5–7

Habit formed, streak tracked, premium offer shown

Section 3 — Feature Tiers: Free vs. Premium
Monetization

Feature Tiers

The core meditation library and schedule are available for free. Premium unlocks unlimited AI sessions, the full content catalog, advanced player features, and sleep tools — the strongest triggers to upgrade because they directly impact daily wellbeing.

FeatureFreePremiumCategory
Browse meditation categoriesContent
Play meditations (up to 5/day) unlimitedPlayer
Daily schedule (3 time slots)Schedule
1 media tag per schedule slot multiple tagsSchedule
AI recommendations (3/day) unlimitedAI
AI meditation generationPremiumAI
Full content libraryPremiumContent
Download for offline playPremiumPlayer
Sleep timer & auto-stopPremiumPlayer
Background play (lock screen)PremiumPlayer
Practice streak trackingPremiumProgress
Session history & statsPremiumProgress
Multiple tag selections per slotPremiumSchedule
AI conversation historyPremiumAI
Key upgrade trigger: The sleep timer and background audio are the most requested premium features. Users who start using the evening schedule slot consistently convert to Premium within 7 days — they need background play to use the app in bed without holding the phone.
Section 4 — Authentication & Onboarding Flow
Auth & Onboarding

Authentication & Onboarding

The onboarding uses the midnight navy + teal palette from the brand design SVG. Splash screen 3-step onboarding carousel Login or Register. The auth forms follow the same field structure and validation logic as the admin panel (email + password, Google Sign-In, email confirmation flow), adapted for the mobile-first dark UI.

Auth Service Integration

Splash — Onboarding
9:41● ●
Meditation
Your daily mindfulness companion
Build Your Daily Ritual
Set three personalized time slots — morning, afternoon, and evening — and receive the right meditation at the right moment.
Get Started
Already have an account? Sign In
Sign In
9:41● ●
Welcome back
Sign in to continue your practice
Email
your@email.com
Password
••••••••
Forgot password?
Sign In
OR
Continue with Google
Continue with Apple
No account? Register
Register
9:41● ●
Start your journey
Free to join · No credit card
Username
your_name
Email
your@email.com
Password
Min 8 characters
Strong password
Create Account
By registering you agree to our Terms and Privacy Policy
Have an account? Sign In

Onboarding Steps — 3 Screens

1

Welcome — Your Practice

Introduces the app mission. Full-screen dark background with centered meditation figure and app tagline. "Get Started" CTA button + "Sign In" link.

2

Daily Schedule

Explains the three-slot schedule concept with a simple illustration of Morning/Afternoon/Evening blocks. Sets expectation of personalized delivery.

3

AI Guide

Introduces the AI assistant with the purple panel visual. Explains it will learn preferences and generate new sessions. Leads to registration.

Section 5 — Home Screen: Schedule & Categories
Main Screen

Home Screen

The home screen has two zones: the Daily Schedule panel at the top shows the user's three time slots with today's assigned meditations. Below it the Content Categories grid lists all available meditation categories with their media tags. The AI FAB is always visible in the bottom nav.

Schedule logic: The server attaches meditations to slots at delivery time (GET /user/schedule/content). The client calls this endpoint when the schedule panel is opened or refreshed. Each slot is matched by the user's configured media tag and the time-of-day context.
Home — Schedule + Categories
9:41● ●
Good morning, Alex
Your today's practice is ready
Today's Schedule
Morning · 7:00
Morning Breath
Breathing · 10 min
Play
Afternoon · 13:00
Focus Reset
Focus · 7 min
Later
Evening · 21:30
Sleep Journey
Sleep · 20 min
Later
Categories
Breathing
24 sessions
Pranayama4-7-8
Stress Relief
18 sessions
AnxietyCalm
Browse Categories
9:41● ●
All Categories
Sleep
31 sessions
Body ScanNSDRNight
Focus
16 sessions
ConcentrationFlow
Nature Sounds
22 sessions
ForestRainOcean
Mantra
14 sessions
SanskritTibetan
Morning Energy
20 sessions
EnergizingGratitude
Category Detail
9:41● ●
Sleep Meditations
31 sessions · Avg 20 min
Body ScanNSDRNightRelaxation
Sessions
Ocean Drift
NSDR · 22 min
Body Scan Journey
Body Scan · 18 min
Night Relaxation
Relaxation · 25 min
Section 6 — Daily Schedule Setup
Schedule

Daily Schedule — Three Time Slots

The schedule screen lets users configure exactly when each meditation slot fires and — critically — which media tag is assigned to that slot. The server uses the user's tag preference (PUT /user/media/tag) and the slot time (PUT /user/schedule) to serve the matching content at delivery time via GET /user/schedule/content.

Data model: Each slot stores: slot_time (HH:MM), media_tag_id (reference to the user's preferred tag), and enabled boolean. GET /user/schedule/content returns the resolved session (title, duration, category, media URL) for each enabled slot.
Schedule Setup
9:41● ●
Configure three daily meditation slots. Pick a time and a content tag for each.
Morning
Wake-up & energize
Time
07:00
Content Tag
Breathing
Afternoon
Midday reset
Time
13:00
Content Tag
Focus
Evening
Wind-down & sleep
Time
21:30
Content Tag
Sleep
Tag Picker (Bottom Sheet)
9:41● ●
Select a media tag for your Morning slot. The app will serve meditations with this tag at 07:00.
Breathing
24 sessions
Gratitude
12 sessions
Energizing
16 sessions
Mindfulness
20 sessions
Body Scan
18 sessions
Mantra
14 sessions
Confirm: Breathing
Schedule API

Endpoints

  • GET /user/schedule
    Returns all 3 slot configs for user
  • PUT /user/schedule
    Update slot time + media tag
  • GET /user/schedule/content
    Returns resolved meditation for each enabled slot
  • PUT /user/media/tag
    Set user's preferred media tags
  • GET /content/category
    List all categories with tag list
  • GET /user/category
    User's saved category preferences

Schedule Payload

{
 "slot": "morning",
 "slot_time": "07:00",
 "media_tag_id": "...",
 "enabled": true
}
Section 7 — Meditation Media Player
Player

Meditation Player

The meditation player is full-screen, immersive, and minimal. A pulsing breathing-ring animation fills the center during audio sessions. Controls are large and thumb-friendly. The ambient background gradient shifts slowly to match the session's mood (sleep = deep purple, morning = warm amber, focus = cool teal).

Now Playing
9:41● ●
Now Playing
Ocean Drift
Sleep · Body Scan
NSDRNight
8:1422:00
Sleep Timer (Premium)
9:41● ●
Sleep Timer
25:00
remaining
Quick Presets
10 min
25 min
45 min
60 min
90 min
Custom
Body Scan Journey
Playing · 18 min
Auto-stop after timer
Session ends silently
Player Features

Free

  • Play / pause / seek
  • Skip forward 30s / back 15s
  • Volume control
  • Waveform progress visualization
  • Session info (title, tag, duration)
  • Share session

Premium

  • Sleep timer with auto-stop
  • Background play (lock screen)
  • Offline download
  • Ambient background visuals
  • Breathing ring animation
  • AirPlay / Chromecast output
  • Session history & completion tracking

Ambient Moods

  • Morning — warm amber gradient
  • Focus — cool teal gradient
  • Evening / Sleep — soft purple
  • Nature — green midnight
Section 8 — AI Meditation Assistant
AI Assistant

AI Meditation Guide

The AI assistant is a persistent, conversational meditation guide. It recommends sessions from the existing library based on current mood, recent history, and time of day. For Premium users it also generates custom guided meditations on demand — producing a unique script, narration plan, or audio session aligned to the user's stated need.

AI Service: Connected to the service_ai backend module. Free tier: 3 recommendation requests/day. Premium: unlimited recommendations + meditation generation. Session context (last 5 conversations) is maintained server-side per user.
AI — Recommend
9:41● ●
Meditation AI
Online · Mindfulness Guide
I feel stressed and can't concentrate at work
I hear you. When stress breaks your focus, a short breathwork session can reset the nervous system in 5–7 minutes.

I recommend: 4-7-8 Breathing from the Breathing category — 6 minutes, starts immediately.
4-7-8 Breathing
Breathing · Focus · 6 min
Play
Something longer for after work?
Great idea. For evening decompression I suggest Body Scan Journey — 18 min, deep muscle relaxation. Perfect for the transition from work to home.
AI Generate (Premium)
9:41● ●
Describe exactly what you need — the AI will create a personalized guided session just for you.
Current Mood
Anxious
Sad
Angry
Tired
Numb
Good
Duration
5 min
10 min
15 min
20 min
What do you need?
I'm feeling sad after a difficult conversation and just want to find some inner calm and self-compassion.
Style
Guided Voice
Nature Sounds
Binaural
Generate My Meditation
AI History (Premium)
9:41● ●
Conversations
7 total
Stress at work — breathing needed
Today, 9:40
Can't sleep, generate 15-min body scan
Yesterday
Morning energy boost after bad night
2 days ago
Anxiety before presentation · 5 min
3 days ago
Generated: Sad mood · self-compassion
4 days ago

Generated Sessions
Self-Compassion · 10 min
Generated · 4 days ago
Body Scan for Sleep · 15 min
Generated · Yesterday
Section 9 — Web / Desktop Layout
Desktop / Web

Desktop Web Layout

The web layout uses a three-column structure: a fixed left sidebar for navigation, the main content area for categories and the schedule panel, and a right AI assistant panel that can be toggled open. The dark midnight theme carries over from mobile seamlessly.

Alex
A

Navigation

Home
Browse
Schedule
Player
AI Guide
Saved
Progress

My Tags

Breathing Focus Sleep NSDR
Good morning, Alex
Monday, 11 May 2026 · Your practice is ready

Today's Schedule

Morning · 07:00
Morning Breath
Breathing · 10 min
▶ Play Now
️ Afternoon · 13:00
Focus Reset
Focus · 7 min
Later
Evening · 21:30
Sleep Journey
Sleep · 20 min
Later

Categories

Breathing
24 sessions
Sleep
31 sessions
Stress Relief
18 sessions
Focus
16 sessions
AI Guide
Ask me anything about meditation
Good morning! Based on your busy schedule today, I suggest starting with a 5-minute 4-7-8 breathing exercise to ground yourself before work.
Stress meditation for today
Generate: calm morning 10 min
Section 10 — Technical Architecture & API
Architecture

Technical Architecture

Built on a modern microservice architecture following industry best practices — each domain is independently deployable, scalable, and observable. The platform integrates cutting-edge therapeutic methodologies drawn from three traditions: the contemplative wisdom of Tibetan Buddhism and Eastern philosophy, the somatic and mindfulness-based approaches of modern Western psychology, and the structured frameworks of European and American psychoanalysis. This fusion ensures every session is grounded in both ancient inner science and evidence-based clinical practice.

Frontend Stack

  • React 18 — component tree, hooks, context API
  • TypeScript — strict typing across all services
  • Vite — dev server and build tool (see vite.config.ts)
  • Tanstack Query — server state, caching, refetch logic
  • React Router v6 — SPA routing with protected routes
  • Zustand — lightweight client state (player, schedule)
  • Lucide React — icon library consistent with this spec
  • Tailwind CSS — utility-first styling with dark theme tokens
  • Howler.js — cross-platform audio engine for the player

Auth Flow (JWT)

  • JWT stored in localStorage via authStorage utility
  • Axios interceptor attaches Authorization: Bearer <token>
  • Token refresh on 401 via auth.service.ts refreshToken()
  • Route guard: <ProtectedRoute> redirects to /login if no token
  • Google OAuth via Firebase; Apple Sign-In via Apple JS SDK

Complete User Flow

Install

Splash 3 onboarding slides

Auth

Register or Sign In (email / Google / Apple)

Setup

Set 3 schedule slots + pick media tag each

Home

Today schedule at top, categories below

Play

Open player, breathing ring, sleep timer

AI

Recommend or generate custom session

Premium

Unlock unlimited AI, sleep timer, downloads