# Tara -- Product Features

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./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

1. [Guided Meditations](#1-guided-meditations)
2. [Meditation Timer](#2-meditation-timer)
3. [Breathing Exercises](#3-breathing-exercises)
4. [Courses & Learning Paths](#4-courses--learning-paths)
5. [Audio Player](#5-audio-player)
6. [Ambient Sounds & Sound Mixer](#6-ambient-sounds--sound-mixer)
7. [Progress Tracking & Statistics](#7-progress-tracking--statistics)
8. [Streaks & Motivation](#8-streaks--motivation)
9. [Achievements & Milestones](#9-achievements--milestones)
10. [Teacher Profiles](#10-teacher-profiles)
11. [Library & Favorites](#11-library--favorites)
12. [Search & Discovery](#12-search--discovery)
13. [Offline Downloads](#13-offline-downloads)
14. [Personalized Recommendations](#14-personalized-recommendations)
15. [Onboarding & Goal Setting](#15-onboarding--goal-setting)
16. [Notifications & Reminders](#16-notifications--reminders)
17. [Subscriptions & Premium Content](#17-subscriptions--premium-content)
18. [User Account & Settings](#18-user-account--settings)
19. [Accessibility](#19-accessibility)
20. [Internationalization](#20-internationalization)
21. [Progressive Web App (PWA)](#21-progressive-web-app-pwa)
22. [Mobile App](#22-mobile-app)
23. [Analytics & Experimentation](#23-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

### 10.1 Teacher Information

| 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

### 22.1 Platform Support

| 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                                  |
