Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs
center. This file is its operational companion (service topology, APIs,
schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Meditation & Mindfulness Platform
Tara helps users develop a consistent meditation practice through guided
meditations, breathing exercises, a customizable timer, multi-day courses,
progress tracking, and offline access. Available as a Progressive Web App and
native iOS/Android apps. This document describes every capability available to
users.
Table of Contents#
- Guided Meditations
- Meditation Timer
- Breathing Exercises
- Courses & Learning Paths
- Audio Player
- Ambient Sounds & Sound Mixer
- Progress Tracking & Statistics
- Streaks & Motivation
- Achievements & Milestones
- Teacher Profiles
- Library & Favorites
- Search & Discovery
- Offline Downloads
- Personalized Recommendations
- Onboarding & Goal Setting
- Notifications & Reminders
- Subscriptions & Premium Content
- User Account & Settings
- Accessibility
- Internationalization
- Progressive Web App (PWA)
- Mobile App
- Analytics & Experimentation
1. Guided Meditations#
1.1 Content Categories#
Tara offers guided meditations organized into 15 categories:
| Category |
Description |
Icon |
| Stress Relief |
Reduce tension and find calm |
Leaf |
| Sleep |
Fall asleep faster and rest deeper |
Moon |
| Focus |
Improve concentration and mental clarity |
Lightbulb |
| Anxiety |
Feel calmer and more grounded |
Heart |
| Self-Compassion |
Cultivate kindness toward yourself |
Sparkles |
| Self-Love |
Build a healthy relationship with yourself |
Heart |
| Relationships |
Deepen connection with others |
People |
| Gratitude |
Develop appreciation and joy |
Flower |
| Morning |
Start the day with intention |
Sunrise |
| Evening |
Wind down and prepare for rest |
Sunset |
| Breathing |
Guided breath-focused practices |
Wind |
| Body Scan |
Progressive body awareness |
Body |
| Walking |
Mindful walking meditations |
Walking |
| Work |
Stay centered during your workday |
Briefcase |
| Beginners |
Start your meditation journey |
Seedling |
1.2 Content Types#
| Type |
Description |
| Guided |
Instructor-led meditations with spoken guidance |
| Unguided |
Silent meditations with optional ambient sounds and bells |
| Music |
Meditative music compositions |
| Soundscape |
Nature sounds and ambient environments |
| Story |
Narrative-based meditations (e.g., sleep stories) |
1.3 Difficulty Levels#
| Level |
Description |
| Beginner |
Simple techniques, shorter sessions, more guidance |
| Intermediate |
Moderate complexity, varied techniques |
| Advanced |
Deeper practices, longer durations, less hand-holding |
| All Levels |
Suitable for everyone |
1.4 Session Durations#
Meditations range from quick 5-minute sessions to extended 60+ minute deep
practices. Users can filter by duration preference:
| Duration |
Label |
| 5-10 min |
Quick Sessions |
| 10-20 min |
Balanced |
| 20+ min |
Deep Sessions |
| Any length |
Mix It Up |
1.5 Meditation Details#
Each meditation includes:
| Field |
Description |
| Title |
Descriptive name of the meditation |
| Description |
Short summary of the practice |
| Teacher |
Instructor who recorded the meditation |
| Category |
Primary category (e.g., Sleep, Focus) |
| Duration |
Total length in minutes |
| Difficulty level |
Beginner, Intermediate, Advanced, All |
| Benefits |
What the user will gain from this practice |
| Tags |
Searchable keywords |
| Play count |
How many times the meditation has been played |
| Rating |
Average user rating (1-5 stars) |
| Rating count |
Number of ratings received |
| Premium indicator |
Whether this requires a subscription |
| Download indicator |
Whether this can be saved for offline use |
1.6 Session Ratings & Notes#
After completing a meditation, users can:
| Feature |
Description |
| Rate the session |
1-5 star rating |
| Add personal notes |
Free-form text notes about the experience |
| View session completion screen |
See duration, streak status, and any new achievements |
2. Meditation Timer#
2.1 Timer Configuration#
| Feature |
Description |
| Duration presets |
Quick-select: 1, 5, 10, 15, 20, 30, 45, 60 minutes |
| Custom duration |
Set any duration manually |
| Preparation phase |
Optional countdown before the timer starts |
| Wind-down phase |
Gentle ending period before the timer completes |
| Timer presets |
Save and reuse favorite timer configurations |
2.2 Timer Controls#
| Control |
Description |
| Start |
Begin the meditation timer |
| Pause / Resume |
Temporarily stop and continue |
| Stop / End |
End the session early |
| Full-screen mode |
Distraction-free timer display |
| Background operation |
Timer continues when the app is in the background |
2.3 Timer Phases#
The timer moves through distinct phases:
| Phase |
Description |
| Idle |
Timer is configured but not started |
| Preparing |
Optional preparation countdown |
| Running |
Main meditation duration in progress |
| Paused |
Timer is paused by the user |
| Completed |
Timer has finished |
2.4 Bells#
| Feature |
Description |
| Start bell |
Bell sound when the timer begins |
| End bell |
Bell sound when the timer completes |
| Interval bells |
Recurring bells at set intervals during the session |
| Bell selection |
Choose from: Tibetan Bowl, Zen Bell, Crystal Bowl, Chime, Temple Bell, and more |
| Bell volume |
Independent volume control for bells |
| Bell preview |
Preview bell sounds before starting |
2.5 Timer Integration#
| Feature |
Description |
| Ambient sounds |
Mix ambient sounds with the timer |
| Session tracking |
Timer sessions are recorded in progress history |
| Keyboard shortcuts |
Control the timer via keyboard (web) |
| Drift correction |
Precise timing that accounts for system clock drift |
3. Breathing Exercises#
3.1 Built-In Breathing Patterns#
| Pattern |
Timing (inhale-hold-exhale-hold) |
Purpose |
| Box Breathing |
4-4-4-4 |
Stress relief, grounding |
| 4-7-8 Technique |
4-7-8-0 |
Sleep aid, deep relaxation |
| Coherent Breathing |
5.5-0-5.5-0 |
Heart rate variability, calm |
| Energizing Breath |
2-0-2-0 |
Wakefulness, energy boost |
| Calming Breath |
4-0-6-0 |
Anxiety reduction, calm |
| 2:1 Ratio |
4-0-8-0 |
Deep relaxation, parasympathetic activation |
| Alternate Nostril |
Variable |
Balance, mental clarity |
| Wim Hof Method |
2-0-2-15 |
Energy, cold tolerance, focus |
| Sleep Breath |
4-7-8-0 |
Sleep preparation |
| Focus Breath |
4-4-4-0 |
Concentration, mental clarity |
3.2 Pattern Discovery#
| Feature |
Description |
| Browse by category |
Relaxation, Focus, Energy, Meditation |
| Browse by difficulty |
Beginner-friendly to advanced patterns |
| Pattern descriptions |
Each pattern includes purpose, benefits, and recommended cycles |
| Recommended cycle count |
Suggested number of breath cycles per session |
3.3 Custom Patterns#
| Feature |
Description |
| Pattern builder |
Create custom breathing patterns with configurable phase durations |
| Phase configuration |
Set inhale, hold-in, exhale, and hold-out durations independently |
| Create from ratio |
Quick creation using breath ratios (e.g., 1:2, 1:1:2) |
| Save custom patterns |
Store personal patterns for reuse |
3.4 Exercise Guidance#
| Feature |
Description |
| Visual breathing animation |
Animated circle/shape that expands and contracts with the breath |
| Phase labels |
On-screen labels ("Inhale," "Hold," "Exhale") |
| Phase countdown |
Seconds remaining in the current phase |
| Cycle counter |
Current cycle number out of total target |
| Audio guidance cues |
Optional audio prompts for phase transitions |
| Haptic feedback |
Vibration patterns synchronized with breathing phases (mobile) |
| Color-coded phases |
Each phase (inhale, hold, exhale) displayed in a distinct color |
3.5 Session Control#
| Feature |
Description |
| Completion modes |
Set target by number of cycles, total duration, or open-ended |
| Pause / Resume |
Pause the exercise mid-cycle |
| Session history |
Breathing sessions recorded in progress tracking |
4. Courses & Learning Paths#
4.1 Course Structure#
| Feature |
Description |
| Multi-day programs |
Structured courses spanning multiple days (e.g., "7-Day Stress Relief") |
| Sequential lessons |
Daily meditations that build on each other |
| Course description |
Overview of what the course covers and expected outcomes |
| Teacher attribution |
Courses are led by specific teachers |
| Total duration |
Combined duration of all meditations in the course |
| Premium indicator |
Whether the course requires a subscription |
4.2 Course Progress#
| Feature |
Description |
| Current day tracking |
See which day of the course you are on |
| Completed days |
View which days have been finished |
| Lesson status |
Each lesson marked as: Not Started, In Progress, Completed, Locked |
| Course sections |
Courses organized into logical sections |
| Overall completion |
Percentage of course completed (0-100%) |
| Start / Resume |
Begin a new course or continue where you left off |
4.3 Collections#
| Feature |
Description |
| Curated collections |
Themed groups of meditations (e.g., "Morning Routines," "Sleep Toolkit") |
| Featured collections |
Highlighted collections on the home screen |
| Collection progress |
Track your progress through any collection |
| Total duration |
Combined time for all meditations in a collection |
5. Audio Player#
5.1 Playback Controls#
| Control |
Description |
| Play / Pause |
Start or pause the current meditation |
| Seek / Scrub |
Drag the progress bar to any position |
| Skip forward / back |
Jump forward or backward in the audio |
| Previous / Next |
Navigate between meditations in a collection or queue |
| Playback speed |
Adjust speed: 0.5x, 0.75x, 1.0x, 1.25x, 1.5x, 2.0x |
5.2 Player Modes#
| Mode |
Description |
| Full-screen player |
Immersive player with artwork, waveform visualization, and all controls |
| Mini player |
Compact player bar that persists while browsing the app |
| Lock screen controls |
Control playback from the device lock screen (iOS and Android) |
| Background playback |
Audio continues when the app is minimized or device is locked |
5.3 Playback Features#
| Feature |
Description |
| Audio streaming |
Stream meditations directly from CDN without full download |
| Quality selection |
Choose audio quality: Low, Medium, High |
| Auto-play next |
Automatically play the next meditation in a collection |
| Continue where you left off |
Resume partially completed meditations from exact position |
| Audio focus management |
Pause other audio apps when meditation starts; resume when it ends |
| Session creation |
A playback session is automatically created and tracked for progress |
6. Ambient Sounds & Sound Mixer#
6.1 Ambient Sound Library#
Sounds organized into four categories:
| Category |
Examples |
| Nature |
Rain, Ocean waves, Forest, Birds, Thunderstorm, River |
| Music |
Soft piano, Ambient pads, Singing bowls |
| White noise |
White noise, Brown noise, Pink noise, Fan |
| Silence |
Pure silence (no ambient sound) |
6.2 Sound Mixer#
| Feature |
Description |
| Mix multiple sounds |
Layer several ambient sounds simultaneously |
| Per-channel volume |
Adjust volume for each individual sound |
| Pan control |
Position sounds in the stereo field (left/right) |
| Sound channel rows |
Visual mixer interface with per-sound controls |
| Independent from player |
Ambient sounds work with both guided meditations and the timer |
| Background sound volume |
Global volume control for all ambient sounds |
7. Progress Tracking & Statistics#
7.1 Core Statistics#
| Metric |
Description |
| Total minutes meditated |
Lifetime meditation time |
| Total sessions completed |
Lifetime session count |
| Today's sessions |
Number of sessions completed today |
| Today's minutes |
Minutes meditated today |
| This week's minutes |
Minutes meditated in the current week |
| Weekly goal progress |
Progress toward weekly goal (e.g., 45/70 minutes) |
7.2 Detailed Analytics#
| Feature |
Description |
| Daily data |
Minutes and sessions per day |
| Weekly summary |
Aggregated weekly statistics |
| Trend tracking |
Visualize meditation trends over time |
| Heatmap view |
Calendar heatmap showing practice intensity |
| Time-of-day distribution |
When you typically meditate (morning, afternoon, evening) |
| Day-of-week distribution |
Which days you practice most |
| Session type distribution |
Breakdown by session type (guided, breathing, timer) |
7.3 Progress Charts#
| Chart View |
Description |
| Daily bar chart |
Minutes per day for the past week/month |
| Weekly trend line |
Week-over-week progress |
| Calendar heatmap |
Visual intensity map across the calendar |
| Session type breakdown |
Pie/bar chart of session types |
7.4 Session History#
| Feature |
Description |
| Complete history |
Browse all past meditation sessions |
| Session details |
View duration, completion percentage, rating, and notes for each session |
| Date filtering |
Filter history by date range |
| Predefined ranges |
Quick filters: Today, This Week, This Month, Last 30 Days, All Time |
7.5 Data Export#
| Feature |
Description |
| Export progress data |
Download your meditation history and statistics |
| Multi-device sync |
Progress syncs across devices when signed in |
| Conflict resolution |
Handles sync conflicts when editing on multiple devices |
8. Streaks & Motivation#
8.1 Streak Tracking#
| Feature |
Description |
| Current streak |
Number of consecutive days with at least one meditation |
| Longest streak |
All-time record streak |
| Streak start date |
When the current streak began |
| Today's status |
Whether the user has meditated today |
| Streak at-risk alerts |
Warning when less than 6 hours remain to maintain the streak |
| Hours until expiry |
Countdown showing how long until the streak breaks |
8.2 Streak Display#
| Feature |
Description |
| Visual streak calendar |
Week-at-a-glance showing completed, missed, and current day |
| Day status indicators |
Completed, Missed, Current, Future |
| Streak milestones |
Special recognition at streak milestones (3, 7, 14, 30, 60, 90, 365 days) |
| Motivational messages |
Contextual encouragement based on streak status |
8.3 Weekly Goals#
| Feature |
Description |
| Weekly minute goal |
Set a target number of minutes per week (default: 70 min / 10 min per day) |
| Weekly progress bar |
Visual progress toward the weekly goal |
| Week reset tracking |
Automatic reset at the start of each week |
9. Achievements & Milestones#
9.1 Achievement System#
| Feature |
Description |
| Achievement badges |
Visual badges earned for reaching milestones |
| Achievement categories |
Streaks, total minutes, session count, exploration, and more |
| Achievement rarity |
Common, Uncommon, Rare, Epic, Legendary |
| Progress tracking |
See progress toward unearned achievements |
| Earn date |
View when each achievement was unlocked |
| Requirement description |
Clear description of what is needed to earn each badge |
9.2 Achievement Examples#
| Achievement |
Requirement |
Rarity |
| First Steps |
Complete your first meditation |
Common |
| One Week |
Maintain a 7-day streak |
Uncommon |
| Centurion |
Complete 100 sessions |
Rare |
| Marathon Meditator |
Meditate for 1,000 total minutes |
Epic |
| Year of Mindfulness |
Maintain a 365-day streak |
Legendary |
9.3 Milestone Notifications#
| Feature |
Description |
| Milestone definitions |
Predefined milestones for key progress markers |
| Milestone categories |
Time-based, session-based, streak-based, exploration-based |
| Notification display |
Celebratory notification when a milestone is reached |
9.4 Session Completion Celebration#
| Feature |
Description |
| Session complete screen |
Animated celebration when a session finishes |
| Session stats display |
Show duration, streak status, and any new achievements |
| Celebration types |
Visual celebration scaled to significance (small win, streak milestone, new achievement) |
10. Teacher Profiles#
| Field |
Description |
| Name |
Instructor's display name |
| Bio |
Professional background and teaching philosophy |
| Profile photo |
Instructor headshot |
| Credentials |
Certifications and training |
| Specialties |
Areas of expertise (e.g., MBSR, Yoga Nidra, Sleep) |
10.2 Teacher Discovery#
| Feature |
Description |
| Teacher directory |
Browse all available teachers |
| Teacher detail page |
View a teacher's full profile, specialties, and meditations |
| Teacher meditations |
See all meditations by a specific teacher |
| Teacher cards |
Compact card components showing teacher photo, name, and specialties |
11. Library & Favorites#
11.1 Personal Library#
| Feature |
Description |
| Favorites collection |
Save meditations to a personal favorites list |
| Toggle favorite |
One-tap add/remove from favorites |
| Download library |
View all downloaded offline content |
| Session history |
Browse previously completed sessions |
11.2 Content Collections#
| Feature |
Description |
| Featured collections |
Curated, staff-picked collections |
| Category browsing |
Browse by meditation category |
| Course library |
View all available courses |
| Recently played |
Quick access to recently listened meditations |
| Continue items |
Resume meditations in progress with saved position |
12. Search & Discovery#
12.1 Search#
| Feature |
Description |
| Full-text search |
Search by meditation title, description, teacher name, or tags |
| Search results |
Results display meditation cards with all key metadata |
| Search from header |
Integrated search bar in the app header |
12.2 Filtering#
| Filter |
Options |
| Category |
All 15 meditation categories |
| Duration |
Short, Medium, Long, Any |
| Level |
Beginner, Intermediate, Advanced, All |
| Content type |
Guided, Unguided, Music, Soundscape, Story |
| Premium/Free |
Filter by subscription requirement |
| Teacher |
Filter by specific instructor |
12.3 Discovery#
| Feature |
Description |
| Featured meditations |
Editorially curated featured content |
| Daily meditation pick |
Personalized daily suggestion with a motivational message and time-of-day recommendation |
| Category carousels |
Horizontal scroll of meditations per category |
| Recommended for you |
Personalized suggestions based on goals and history |
13. Offline Downloads#
13.1 Download Management#
| Feature |
Description |
| Download meditations |
Save meditations to the device for offline listening |
| Download progress |
Visual progress bar during download |
| Download queue |
Queue multiple downloads with priority ordering |
| Resume downloads |
Interrupted downloads resume automatically |
| WiFi-only option |
Restrict downloads to WiFi connections only |
| Checksum verification |
Validate file integrity after download |
13.2 Storage Management#
| Feature |
Description |
| Storage usage display |
See how much space downloaded content occupies |
| Cleanup strategies |
Automatic removal of old or expired downloads |
| Content expiration |
Downloads expire after a configurable period |
| Remove downloads |
Delete individual or all downloaded content |
13.3 Offline Playback#
| Feature |
Description |
| Offline detection |
App detects when the device is offline |
| Offline library |
Browse and play downloaded content without internet |
| Offline page |
Dedicated offline-mode page showing available content |
| Smart download suggestions |
Suggestions for content to download based on preferences |
| Content versioning |
Downloaded content updates when newer versions are available |
14. Personalized Recommendations#
14.1 Daily Meditation#
| Feature |
Description |
| Personalized daily pick |
A meditation suggested based on goals, time of day, and history |
| Recommended time |
Morning, afternoon, evening, or anytime suggestion |
| Personalized message |
Motivational message accompanying the daily suggestion |
14.2 Goal-Based Recommendations#
Users' onboarding goals drive content suggestions:
| Goal |
Recommended Content |
| Reduce Stress |
Stress relief meditations, body scans, breathing exercises |
| Improve Sleep |
Sleep meditations, evening practices, sleep stories |
| Increase Focus |
Focus meditations, breathing exercises, mindful work practices |
| Manage Anxiety |
Anxiety relief, calming breath, grounding practices |
| Build a Habit |
Short daily meditations, streak-building challenges |
| Personal Growth |
Self-compassion, gratitude, relationship meditations |
| Find Inner Calm |
Mindfulness practices, nature soundscapes, unguided sits |
15. Onboarding & Goal Setting#
15.1 Onboarding Flow#
| Step |
Description |
| Welcome |
Introduction to Tara and its benefits |
| Goals |
Select primary meditation goals (multi-select from 7 options) |
| Experience level |
Choose: New to Meditation, Some Experience, Regular Practice |
| Session preference |
Preferred duration: Quick (5-10 min), Balanced (10-20 min), Deep (20+ min), Mix |
| Preferred time |
When to meditate: Morning, Afternoon, Evening, Anytime |
| Weekly goal |
Set weekly meditation target in minutes (default: 70 min) |
| Trial start |
Begin free trial or explore free content |
15.2 Preference Storage#
| Feature |
Description |
| Goal tracking |
Selected goals stored and used for content recommendations |
| Experience adaptation |
Content difficulty adjusted to experience level |
| Duration matching |
Meditation suggestions match duration preference |
| Schedule alignment |
Reminders and suggestions aligned to preferred time |
16. Notifications & Reminders#
16.1 Notification Types#
| Notification |
Description |
Default |
| Daily reminder |
Reminder to meditate at your preferred time |
On, 8:00 AM |
| Streak reminder |
Alert when your streak is at risk of breaking |
On |
| New content |
Notification when new meditations or courses are added |
On |
| Weekly summary |
End-of-week summary of your meditation practice |
On |
| Marketing / promotional |
Platform news and offers |
Off |
16.2 Push Notifications (Mobile)#
| Feature |
Description |
| APNS (iOS) |
Apple Push Notification Service for iPhone/iPad |
| FCM (Android) |
Firebase Cloud Messaging for Android devices |
| Local scheduling |
Schedule local notifications for reminders |
| Badge count management |
Update app badge with unread notification count |
| Deep link handling |
Tapping a notification navigates to the relevant screen |
16.3 Notification Controls#
| Feature |
Description |
| Per-type toggles |
Enable/disable each notification type independently |
| Reminder time |
Set the daily reminder time (HH:MM format) |
| All notifications toggle |
Master switch to disable all notifications |
17. Subscriptions & Premium Content#
17.1 Subscription Tiers#
| Tier |
Content Access |
Features |
| Free |
Free meditations, timer, breathing exercises, limited courses |
Core features, basic progress tracking |
| Premium |
All meditations, all courses, all teachers |
All features, offline downloads, advanced analytics |
17.2 Payment Methods#
| Platform |
Payment Provider |
Features |
| Web |
Stripe |
Checkout session, customer portal, subscription management |
| iOS |
Apple App Store (via RevenueCat) |
In-app purchase, restore purchases |
| Android |
Google Play Store (via RevenueCat) |
In-app purchase, restore purchases |
17.3 Subscription Management#
| Feature |
Description |
| Current subscription view |
See active plan, status, renewal date |
| Plan selection |
Browse and compare available plans |
| Billing management |
Access customer portal (Stripe) or manage through App Store / Play Store |
| Cross-platform sync |
Subscription purchased on one platform is recognized on all platforms |
| Receipt validation |
Server-side validation of purchase receipts |
| Restore purchases |
Restore previously purchased subscriptions on new devices |
| Cancellation |
Cancel subscription with retained access until period end |
| Renewal status |
View whether subscription will auto-renew |
| Webhook sync |
Real-time subscription status updates via payment provider webhooks |
17.4 Premium Content Gating#
| Feature |
Description |
| Premium indicators |
Clear visual markers on premium content |
| Upgrade prompts |
Contextual prompts when accessing premium content as a free user |
| Paywall screen |
Subscription screen shown when tapping locked content |
18. User Account & Settings#
18.1 Authentication#
| Feature |
Description |
| Email / password registration |
Create an account with email and password |
| Google OAuth |
Sign in with Google |
| Apple Sign-In |
Sign in with Apple (iOS) |
| Email verification |
Verify email address after registration |
| Forgot password |
Request a password reset link via email |
| Reset password |
Set a new password via secure reset flow |
| Token-based auth |
JWT access tokens (1 hour) with refresh token rotation (24 hours) |
| Account lockout |
Automatic lockout after repeated failed login attempts |
18.2 Profile Settings#
| Setting |
Description |
| Display name |
Set or change your name |
| Profile photo |
Upload or change your profile picture |
| Email |
View account email |
| Password change |
Update your password (Security settings) |
18.3 Playback Preferences#
| Setting |
Description |
| Auto-play next |
Automatically play the next meditation in a collection |
| Download on WiFi only |
Restrict downloads to WiFi connections |
| Audio quality |
Low, Medium, High |
| Bell volume |
Independent volume for bell sounds (0-100%) |
| Background sound volume |
Default volume for ambient sounds (0-100%) |
18.4 Theme & Display#
| Setting |
Description |
| Theme mode |
Light, Dark, or System (follow device setting) |
| Language |
Select display language |
19. Accessibility#
19.1 Visual Accessibility#
| Feature |
Description |
| Screen reader support |
Full ARIA annotation and semantic HTML for screen readers |
| Keyboard navigation |
Complete keyboard access on web |
| Focus management |
Proper focus trapping in modals and overlays |
| High contrast |
Accessible color schemes for low-vision users |
| Accessible theme hook |
Dynamic theme that respects system accessibility settings |
| Skip navigation |
Skip-to-content links for keyboard users |
19.2 Motion & Interaction#
| Feature |
Description |
| Reduced motion |
Respects prefers-reduced-motion system setting |
| Touch targets |
Adequately sized tap targets on mobile |
| Safe area handling |
Proper handling of device notches, rounded corners, and system UI |
| Keyboard avoiding |
Content shifts to remain visible when the keyboard is open |
19.3 Content Accessibility#
| Feature |
Description |
| Image alt text |
Descriptive alt text for all images |
| Color independence |
Information never conveyed by color alone |
| Text scaling |
UI responds to user's preferred text size |
| Accessibility testing |
Automated accessibility tests in the component library |
20. Internationalization#
20.1 Multi-Language Support#
| Feature |
Description |
| Locale-based routing |
URLs structured as /[locale]/page (e.g., /en/meditate) |
| Translation system |
Full translation via next-intl on web |
| Date/time localization |
Dates and times formatted per locale |
| Number formatting |
Numbers formatted per locale |
20.2 Supported Locales#
The platform supports multiple locales with locale-specific routing and content
adaptation. New languages can be added by providing translation files.
21. Progressive Web App (PWA)#
21.1 PWA Capabilities (Web)#
| Feature |
Description |
| Installable |
Add to home screen on desktop and mobile browsers |
| Offline page |
Dedicated offline experience when internet is unavailable |
| Service worker |
Background caching for faster loading and offline support |
| App-like experience |
Full-screen mode, custom splash screen, native-feeling navigation |
| Server-side rendering |
Next.js SSR for fast initial page loads and SEO |
21.2 Web-Specific Features#
| Feature |
Description |
| Responsive design |
Adapts to any screen size from phone to desktop |
| Breadcrumb navigation |
Hierarchical navigation for deep pages |
| Keyboard shortcuts |
Control timer and player via keyboard |
| URL sharing |
Share direct links to meditations and courses |
22. Mobile App#
| Platform |
Framework |
Distribution |
| iOS |
Expo / React Native |
Apple App Store |
| Android |
Expo / React Native |
Google Play Store |
22.2 Mobile-Specific Features#
| Feature |
Description |
| Background audio |
Meditations play when app is backgrounded or device is locked |
| Lock screen controls |
Play/pause from the lock screen media controls |
| Push notifications |
APNs (iOS) and FCM (Android) for reminders and alerts |
| In-app purchases |
Native subscription via App Store and Play Store (RevenueCat) |
| Haptic feedback |
Vibration patterns for breathing exercises and timer events |
| Tab navigation |
Bottom tab bar: Home, Explore, Timer, Library, Profile |
| Bottom sheet |
Native bottom sheet UI for settings and options |
| Safe area handling |
Proper rendering around notches and system UI |
| EAS builds |
Managed build and deployment via Expo Application Services |
22.3 Mobile Onboarding#
| Feature |
Description |
| Welcome flow |
Step-by-step onboarding: Welcome -> Goals -> Schedule -> Trial |
| Goal selection |
Tap to select multiple meditation goals |
| Schedule configuration |
Choose preferred time and duration |
23. Analytics & Experimentation#
23.1 Event Tracking#
| Feature |
Description |
| Custom event tracking |
Track user actions like meditation starts, completions, searches |
| Session-scoped events |
Events linked to specific user sessions |
| Anonymous tracking |
Events can be tracked without requiring authentication |
23.2 Feature Flags#
| Feature |
Description |
| Feature flag system |
Toggle features on/off without deployment |
| Gradual rollout |
Roll out features to a percentage of users |
| Targeting rules |
Target flags by user attributes, platform, or locale |
23.3 A/B Experiments#
| Feature |
Description |
| Experiment variants |
Define multiple variants of a feature or UI |
| User allocation |
Automatically assign users to experiment groups |
| Targeting |
Target experiments by user attributes |
| Status management |
Experiments can be draft, running, paused, or completed |
| Variant exposure |
Track which variant each user sees for analysis |
Feature Summary#
| Category |
Feature Count |
Highlights |
| Guided Meditations |
20+ |
15 categories, 5 content types, 4 difficulty levels, ratings & notes |
| Timer |
15+ |
Duration presets, custom duration, bells, intervals, background operation |
| Breathing Exercises |
15+ |
10 built-in patterns, custom pattern builder, visual animation, haptic feedback |
| Courses |
10+ |
Multi-day programs, sequential lessons, progress tracking, sections |
| Audio Player |
10+ |
Full/mini player, playback speed, lock screen, background audio |
| Sound Mixer |
5+ |
Multi-channel mixing, per-channel volume, pan control |
| Progress Tracking |
15+ |
Lifetime stats, daily/weekly data, heatmaps, session history, data export |
| Streaks |
10+ |
Current/longest streak, at-risk alerts, milestones, weekly goals |
| Achievements |
10+ |
Badge system, rarity tiers, progress tracking, session celebrations |
| Teachers |
5+ |
Profiles, specialties, credentials, teacher-specific content browse |
| Library & Favorites |
5+ |
Favorites, downloads, history, recently played, continue listening |
| Search & Discovery |
10+ |
Full-text search, multi-filter, featured content, daily picks |
| Offline Downloads |
10+ |
Download queue, resume, WiFi-only, storage management, expiration |
| Recommendations |
5+ |
Goal-based, time-of-day, personalized daily pick |
| Onboarding |
5+ |
Multi-step flow, goal setting, experience level, schedule setup |
| Notifications |
10+ |
Daily reminder, streak alerts, new content, weekly summary, deep links |
| Subscriptions |
10+ |
Free/Premium tiers, Stripe/RevenueCat, cross-platform sync, restore |
| Account & Settings |
10+ |
Multi-auth (email, Google, Apple), profile, playback prefs, theme |
| Accessibility |
10+ |
Screen reader, keyboard nav, high contrast, reduced motion, accessible theme |
| i18n |
5+ |
Locale routing, translations, date/number formatting |
| PWA |
5+ |
Installable, offline page, service worker, SSR |
| Mobile |
10+ |
Background audio, lock screen, push notifications, haptics, IAP |
| Analytics |
5+ |
Event tracking, feature flags, A/B experiments |