Eve library

phase-22.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Phase 22: Tara Meditation Platform (App Store Safe)#

Tara is a meditation-focused application designed to be fully compliant with Apple App Store and Google Play Store guidelines. It shares core meditation infrastructure with Lilith but maintains completely separate content, branding, and user bases. Named after the Buddhist/Hindu goddess of compassion and liberation.

22.1 Foundation & Infrastructure Setup#

22.1.1 Directory Structure Creation#

  • 22.1.1.1 [High/S] Create tara root directory

    • Directory: tara/
    • Purpose: Root directory for Tara-specific assets and content
    • Structure: Mirror lilith/ structure where applicable
    • Acceptance: Directory exists with proper .gitkeep
  • 22.1.1.2 [High/S] Create tara content directory structure

    • Directory: tara/content/
    • Subdirs: meditations/, courses/, sleep/, breathing/, sounds/
    • Subdirs: teachers/, programs/, daily/
    • Purpose: All app-store-safe meditation content
    • Acceptance: Content directories exist
  • 22.1.1.3 [High/S] Create tara assets directory structure

    • Directory: tara/assets/
    • Subdirs: images/, icons/, sounds/, fonts/, animations/
    • Subdirs: branding/, marketing/, app-store/
    • Purpose: Brand assets, app icons, marketing materials
    • Acceptance: Asset directories exist
  • 22.1.1.4 [High/S] Create tara configuration directory

    • Directory: tara/config/
    • Files: app.config.ts, features.config.ts, content.config.ts
    • Purpose: Centralized configuration for all Tara apps
    • Acceptance: Config directory with base files exists
  • 22.1.1.5 [High/S] Create apps/tara directory structure

    • Directory: apps/tara/
    • Subdirs: web/, mobile/, api/
    • Purpose: All Tara application code
    • Acceptance: App directories exist
  • 22.1.1.6 [High/S] Create libs/tara directory structure

    • Directory: libs/tara/
    • Subdirs: ui/, content/, features/, analytics/, config/
    • Purpose: Tara-specific libraries
    • Acceptance: Library directories exist
  • 22.1.1.7 [High/S] Create libs/meditation directory structure

    • Directory: libs/meditation/
    • Subdirs: core/, player/, timer/, breathing/, progress/
    • Subdirs: offline/, session/, analytics/
    • Purpose: Shared meditation infrastructure (Tara + Lilith)
    • Acceptance: Meditation library directories exist

22.1.2 Database Configuration#

  • 22.1.2.1 [High/M] Add Tara database to Docker Compose

    • File: docker/docker-compose.dev.yml
    • Database: tara with pgvector extension
    • User: Reuse existing oshun credentials
    • Acceptance: docker compose up creates tara database
  • 22.1.2.2 [High/S] Add Tara database URL to environment

    • File: .env
    • Variable: TARA_DATABASE_URL=postgresql://oshun:oshun_dev@localhost:5432/tara
    • Variable: TARA_REDIS_PREFIX=tara:
    • Acceptance: Environment variables documented and set
  • 22.1.2.3 [High/S] Add Tara database to init script

    • File: docker/scripts/init-multiple-databases.sh
    • Config: POSTGRES_MULTIPLE_DATABASES includes tara
    • Config: Uses pgvector image with required extensions
    • Acceptance: Database auto-creates on fresh docker compose up
  • 22.1.2.4 [High/M] Create Tara database schema migrations directory

    • Directory: libs/tara/database/prisma/migrations/
    • Tool: Drizzle or Prisma (match existing pattern)
    • Purpose: Version-controlled schema migrations
    • Acceptance: Migration infrastructure ready
  • 22.1.2.5 [High/L] Design and create Tara database schema

    • Tables: users, profiles, subscriptions, devices
    • Tables: meditations, courses, lessons, teachers
    • Tables: sessions, progress, streaks, achievements
    • Tables: favorites, downloads, history
    • Tables: notifications, settings, feedback
    • Indexes: Optimize for common queries
    • Acceptance: Complete schema with all tables defined
  • 22.1.2.6 [High/M] Create Tara database seed data

    • File: libs/tara/database/prisma/seed.ts
    • File: libs/tara/database/prisma/seed-test.ts
    • Content: Sample meditations, courses, teachers
    • Content: Test user accounts
    • Purpose: Development and testing data
    • Acceptance: Seed script populates test data

22.1.3 Nx Project Configuration#

  • 22.1.3.1 [High/S] Add Tara scope tag to nx.json

    • File: nx.json
    • Tag: scope:tara
    • Constraint: Tara cannot import from Lilith content
    • Constraint: Tara can import from shared and meditation
    • Acceptance: Tag defined with proper constraints
  • 22.1.3.2 [High/S] Update tsconfig.base.json with Tara paths

    • File: tsconfig.base.json
    • Paths: @tara/* -> libs/tara/*/src/index.ts
    • Paths: @oshun/meditation-* -> libs/meditation/*/src/index.ts
    • Acceptance: TypeScript path resolution works
  • 22.1.3.3 [High/S] Create Tara project naming convention document

    • File: docs/conventions/tara-naming.md
    • Convention: tara-* for apps, @tara/* for libs
    • Convention: @oshun/meditation-* for shared meditation libs
    • Acceptance: Naming conventions documented

22.1.4 Environment & Configuration#

  • 22.1.4.1 [High/M] Create Tara environment configuration

    • File: tara/config/environments/
    • Environments: development, staging, production
    • Variables: API URLs, feature flags, analytics keys
    • Acceptance: Environment configs for all stages
  • 22.1.4.2 [High/M] Create Tara feature flags configuration

    • File: tara/config/features.config.ts
    • Flags: enableOfflineMode, enableSocialFeatures
    • Flags: enablePremiumContent, enableNotifications
    • Flags: enableAnalytics, enableCrashReporting
    • Acceptance: Feature flag system ready
  • 22.1.4.3 [High/S] Create Tara app configuration schema

    • File: tara/config/app.config.ts
    • Config: App name, bundle IDs, version
    • Config: API endpoints, CDN URLs
    • Config: Deep link schemes
    • Acceptance: Centralized app config ready
  • 22.1.4.4 [Medium/M] Create Tara secrets management

    • File: infra/terraform/secrets/tara/
    • Secrets: API keys, signing certificates
    • Secrets: Push notification keys
    • Integration: AWS Secrets Manager or similar
    • Acceptance: Secrets management infrastructure ready

22.2 Shared Meditation Core Library (@oshun/meditation-core)#

22.2.1 Audio Player Engine#

  • 22.2.1.1 [High/L] Create meditation player core library

    • File: libs/meditation/player/src/index.ts
    • Project: @oshun/meditation-player
    • Export: MeditationPlayer class
    • Export: Player state types and interfaces
    • Acceptance: Library compiles and exports correctly
  • 22.2.1.2 [High/XL] Implement MeditationPlayer class

    • File: libs/meditation/player/src/player.ts
    • Method: load(track: MeditationTrack): Promise<void>
    • Method: play(): Promise<void>
    • Method: pause(): void
    • Method: stop(): void
    • Method: seek(position: number): void
    • Method: setPlaybackRate(rate: number): void
    • Method: setVolume(volume: number): void
    • Method: fadeIn(duration: number): Promise<void>
    • Method: fadeOut(duration: number): Promise<void>
    • Method: crossfade(nextTrack: MeditationTrack, duration: number): Promise<void>
    • Events: onStateChange, onProgress, onComplete, onError
    • Acceptance: Full audio playback with fading works
  • 22.2.1.3 [High/L] Implement audio track queue system

    • File: libs/meditation/player/src/queue.ts
    • Class: PlaybackQueue
    • Method: add(track: MeditationTrack): void
    • Method: remove(index: number): void
    • Method: reorder(from: number, to: number): void
    • Method: clear(): void
    • Method: next(): MeditationTrack | null
    • Method: previous(): MeditationTrack | null
    • Feature: Shuffle, repeat modes
    • Acceptance: Queue management fully functional
  • 22.2.1.4 [High/L] Implement background audio support

    • File: libs/meditation/player/src/background.ts
    • Feature: Continue playing when app backgrounded
    • Feature: Lock screen controls integration
    • Feature: Now playing info update
    • Feature: Remote control events handling
    • Platform: Abstract interface for web/iOS/Android
    • Acceptance: Background playback works on all platforms
  • 22.2.1.5 [High/M] Implement audio session management

    • File: libs/meditation/player/src/session.ts
    • Feature: Audio focus handling
    • Feature: Interruption handling (calls, other apps)
    • Feature: Duck audio for notifications
    • Feature: Resume after interruption
    • Acceptance: Graceful handling of audio interruptions
  • 22.2.1.6 [High/L] Implement audio mixing for layered content

    • File: libs/meditation/player/src/mixer.ts
    • Class: AudioMixer
    • Feature: Mix voice guidance with background music
    • Feature: Independent volume controls per layer
    • Feature: Dynamic mixing based on content markers
    • Layer: Voice, Music, Ambient, Effects
    • Acceptance: Multi-layer audio mixing works
  • 22.2.1.7 [Medium/M] Implement audio visualization data

    • File: libs/meditation/player/src/visualization.ts
    • Feature: Frequency data extraction
    • Feature: Waveform data extraction
    • Feature: Real-time amplitude for visualizers
    • Export: Data suitable for React components
    • Acceptance: Visualization data available during playback
  • 22.2.1.8 [High/M] Create audio player React hooks

    • File: libs/meditation/player/src/hooks.ts
    • Hook: useMeditationPlayer()
    • Hook: usePlaybackState()
    • Hook: usePlaybackProgress()
    • Hook: useAudioVisualization()
    • Acceptance: React integration hooks work
  • 22.2.1.9 [High/M] Implement audio caching system

    • File: libs/meditation/player/src/cache.ts
    • Feature: Cache downloaded audio files
    • Feature: LRU eviction policy
    • Feature: Cache size management
    • Feature: Preloading upcoming content
    • Acceptance: Audio caching reduces network usage
  • 22.2.1.10 [Medium/M] Implement audio streaming with buffering

    • File: libs/meditation/player/src/streaming.ts
    • Feature: Progressive download
    • Feature: Buffer management
    • Feature: Quality adaptation based on network
    • Feature: Resume interrupted downloads
    • Acceptance: Streaming playback is smooth

22.2.2 Meditation Timer System#

  • 22.2.2.1 [High/L] Create meditation timer core library

    • File: libs/meditation/timer/src/index.ts
    • Project: @oshun/meditation-timer
    • Export: MeditationTimer class
    • Export: Timer configuration types
    • Acceptance: Library compiles and exports correctly
  • 22.2.2.2 [High/XL] Implement MeditationTimer class

    • File: libs/meditation/timer/src/timer.ts
    • Config: Duration, intervals, bells, ambient sounds
    • Method: start(): void
    • Method: pause(): void
    • Method: resume(): void
    • Method: stop(): void
    • Method: addInterval(time: number, action: IntervalAction): void
    • Method: setEndBell(bell: BellSound): void
    • Method: setIntervalBell(bell: BellSound): void
    • Events: onTick, onInterval, onComplete, onStateChange
    • Acceptance: Full timer functionality works
  • 22.2.2.3 [High/M] Implement timer presets system

    • File: libs/meditation/timer/src/presets.ts
    • Presets: 5min, 10min, 15min, 20min, 30min, 45min, 60min
    • Presets: Custom duration
    • Presets: Pomodoro-style intervals
    • Feature: User-created custom presets
    • Acceptance: Preset system fully functional
  • 22.2.2.4 [High/M] Implement interval bells and sounds

    • File: libs/meditation/timer/src/bells.ts
    • Sounds: Tibetan bowl, gong, chime, bell
    • Sounds: Soft tone, nature sound
    • Feature: Volume control per sound
    • Feature: Custom sound import
    • Acceptance: Bell sounds play at configured intervals
  • 22.2.2.5 [High/M] Implement ambient sound layer for timer

    • File: libs/meditation/timer/src/ambient.ts
    • Sounds: Rain, ocean, forest, wind, fire
    • Sounds: White noise, pink noise, brown noise
    • Sounds: Binaural beats options
    • Feature: Mix multiple ambient sounds
    • Feature: Volume control per sound
    • Acceptance: Ambient sounds layer with timer
  • 22.2.2.6 [Medium/M] Implement timer background operation

    • File: libs/meditation/timer/src/background.ts
    • Feature: Continue timing when app backgrounded
    • Feature: Local notifications for completion
    • Feature: Accurate time tracking across app states
    • Acceptance: Timer accurate even when app suspended
  • 22.2.2.7 [High/M] Create timer React hooks

    • File: libs/meditation/timer/src/hooks.ts
    • Hook: useMeditationTimer(config)
    • Hook: useTimerState()
    • Hook: useTimerProgress()
    • Hook: useTimerPresets()
    • Acceptance: React integration hooks work
  • 22.2.2.8 [Medium/M] Implement timer haptic feedback

    • File: libs/meditation/timer/src/haptics.ts
    • Feature: Gentle vibration at intervals
    • Feature: Completion haptic pattern
    • Feature: Configurable haptic intensity
    • Platform: iOS and Android support
    • Acceptance: Haptic feedback works on mobile

22.2.3 Breathing Exercise Engine ✅#

  • 22.2.3.1 [High/L] Create breathing exercise core library

    • File: libs/meditation/breathing/src/index.ts
    • Project: @oshun/meditation-breathing
    • Export: BreathingExercise class
    • Export: Breathing pattern types
    • Acceptance: Library compiles and exports correctly
  • 22.2.3.2 [High/XL] Implement BreathingExercise class

    • File: libs/meditation/breathing/src/exercise.ts
    • Method: start(pattern: BreathingPattern): void
    • Method: pause(): void
    • Method: resume(): void
    • Method: stop(): void
    • Method: setRepetitions(count: number): void
    • Method: setDuration(minutes: number): void
    • Events: onPhaseChange, onCycleComplete, onExerciseComplete
    • State: Current phase (inhale/hold/exhale/hold), progress, cycle count
    • Acceptance: Full breathing exercise control
  • 22.2.3.3 [High/L] Implement standard breathing patterns

    • File: libs/meditation/breathing/src/patterns.ts
    • Pattern: Box breathing (4-4-4-4)
    • Pattern: 4-7-8 relaxation breathing
    • Pattern: Coherent breathing (5-5)
    • Pattern: Energizing breath (quick inhale, slow exhale)
    • Pattern: Calming breath (slow inhale, quick exhale)
    • Pattern: 2:1 ratio breathing
    • Pattern: Alternate nostril (visualization)
    • Pattern: Wim Hof style (configurable)
    • Acceptance: All standard patterns implemented
  • 22.2.3.4 [High/M] Implement custom breathing pattern builder

    • File: libs/meditation/breathing/src/builder.ts
    • Class: BreathingPatternBuilder
    • Method: inhale(duration: number): this
    • Method: holdIn(duration: number): this
    • Method: exhale(duration: number): this
    • Method: holdOut(duration: number): this
    • Method: repeat(cycles: number): this
    • Method: build(): BreathingPattern
    • Acceptance: Custom patterns can be created
  • 22.2.3.5 [High/M] Implement breathing guidance audio

    • File: libs/meditation/breathing/src/guidance.ts
    • Feature: Voice cues (inhale, exhale, hold)
    • Feature: Tone/bell cues
    • Feature: Configurable voice type
    • Feature: Volume control
    • Acceptance: Audio guidance during exercises
  • 22.2.3.6 [High/M] Implement breathing visualization data

    • File: libs/meditation/breathing/src/visualization.ts
    • Data: Current phase and progress
    • Data: Animation timing values
    • Data: Circle expansion/contraction values
    • Export: Data suitable for React animation
    • Acceptance: Visualization data for UI animation
  • 22.2.3.7 [Medium/M] Implement breathing haptic patterns

    • File: libs/meditation/breathing/src/haptics.ts
    • Feature: Haptic on phase transitions
    • Feature: Gentle rhythm haptics during phases
    • Feature: Configurable intensity
    • Acceptance: Haptic feedback guides breathing
  • 22.2.3.8 [High/M] Create breathing exercise React hooks

    • File: libs/meditation/breathing/src/hooks.ts
    • Hook: useBreathingExercise(pattern)
    • Hook: useBreathingState()
    • Hook: useBreathingAnimation()
    • Hook: useBreathingPatterns()
    • Acceptance: React integration hooks work
  • 22.2.3.9 [Medium/M] Implement breathing session history

    • File: libs/meditation/breathing/src/history.ts
    • Feature: Record completed exercises
    • Feature: Track patterns used
    • Feature: Track duration and cycles
    • Feature: Export session data for progress tracking
    • Acceptance: Session history recorded

22.2.4 Progress Tracking System#

  • 22.2.4.1 [High/L] Create progress tracking core library

    • File: libs/meditation/progress/src/index.ts
    • Project: @oshun/meditation-progress
    • Export: ProgressTracker class
    • Export: Progress data types
    • Acceptance: Library compiles and exports correctly
  • 22.2.4.2 [High/XL] Implement ProgressTracker class

    • File: libs/meditation/progress/src/tracker.ts
    • Method: recordSession(session: MeditationSession): Promise<void>
    • Method: getStreak(): Promise<StreakData>
    • Method: getStatistics(range: DateRange): Promise<Statistics>
    • Method: getHistory(options: HistoryOptions): Promise<SessionHistory>
    • Method: getAchievements(): Promise<Achievement[]>
    • Method: getMilestones(): Promise<Milestone[]>
    • Acceptance: Full progress tracking functionality
  • 22.2.4.3 [High/L] Implement streak calculation system

    • File: libs/meditation/progress/src/streaks.ts
    • Feature: Daily streak tracking
    • Feature: Streak freeze (grace days)
    • Feature: Longest streak record
    • Feature: Streak recovery rules
    • Feature: Timezone-aware day boundaries
    • Acceptance: Accurate streak calculations
  • 22.2.4.4 [High/L] Implement statistics aggregation

    • File: libs/meditation/progress/src/statistics.ts
    • Stat: Total meditation time (all time, week, month, year)
    • Stat: Average session duration
    • Stat: Sessions per week
    • Stat: Most active time of day
    • Stat: Most used meditation types
    • Stat: Completion rate
    • Stat: Consistency score
    • Acceptance: Comprehensive statistics calculated
  • 22.2.4.5 [High/M] Implement achievement system

    • File: libs/meditation/progress/src/achievements.ts
    • Achievement: First meditation
    • Achievement: 7-day streak, 30-day streak, 100-day streak, 365-day streak
    • Achievement: 10 hours, 100 hours, 500 hours total
    • Achievement: Completed first course
    • Achievement: Tried all meditation types
    • Achievement: Early bird (morning meditation)
    • Achievement: Night owl (evening meditation)
    • Feature: Achievement unlock notifications
    • Acceptance: Achievement system tracks and awards
  • 22.2.4.6 [High/M] Implement milestone system

    • File: libs/meditation/progress/src/milestones.ts
    • Milestone: Total minutes meditated (100, 500, 1000, 5000, 10000)
    • Milestone: Total sessions (10, 50, 100, 500, 1000)
    • Milestone: Streak milestones
    • Feature: Milestone celebration UI triggers
    • Acceptance: Milestones tracked and celebrated
  • 22.2.4.7 [Medium/M] Implement progress data export

    • File: libs/meditation/progress/src/export.ts
    • Format: JSON export
    • Format: CSV export
    • Feature: Date range selection
    • Feature: Data type selection
    • Acceptance: User can export their data
  • 22.2.4.8 [High/M] Create progress tracking React hooks

    • File: libs/meditation/progress/src/hooks.ts
    • Hook: useProgressTracker()
    • Hook: useStreak()
    • Hook: useStatistics(range)
    • Hook: useAchievements()
    • Hook: useMilestones()
    • Acceptance: React integration hooks work
  • 22.2.4.9 [Medium/M] Implement progress sync service

    • File: libs/meditation/progress/src/sync.ts
    • Feature: Sync progress to backend
    • Feature: Merge progress from multiple devices
    • Feature: Conflict resolution
    • Feature: Offline-first with eventual consistency
    • Acceptance: Progress syncs across devices

22.2.5 Session Management#

  • 22.2.5.1 [High/L] Create session management core library

    • File: libs/meditation/session/src/index.ts
    • Project: @oshun/meditation-session
    • Export: SessionManager class
    • Export: Session types and interfaces
    • Acceptance: Library compiles and exports correctly
  • 22.2.5.2 [High/XL] Implement SessionManager class

    • File: libs/meditation/session/src/manager.ts
    • Method: createSession(config: SessionConfig): MeditationSession
    • Method: startSession(session: MeditationSession): Promise<void>
    • Method: pauseSession(): void
    • Method: resumeSession(): void
    • Method: completeSession(): Promise<SessionResult>
    • Method: cancelSession(): void
    • Method: getCurrentSession(): MeditationSession | null
    • Events: onSessionStart, onSessionPause, onSessionComplete
    • Acceptance: Full session lifecycle management
  • 22.2.5.3 [High/M] Implement session state persistence

    • File: libs/meditation/session/src/persistence.ts
    • Feature: Save session state on app background
    • Feature: Restore session on app foreground
    • Feature: Handle app crashes gracefully
    • Feature: Partial completion tracking
    • Acceptance: Sessions survive app lifecycle events
  • 22.2.5.4 [High/M] Implement session analytics

    • File: libs/meditation/session/src/analytics.ts
    • Event: Session started
    • Event: Session completed
    • Event: Session abandoned
    • Event: Session paused/resumed
    • Data: Duration, type, completion percentage
    • Acceptance: Session analytics events fire correctly
  • 22.2.5.5 [Medium/M] Implement session scheduling

    • File: libs/meditation/session/src/scheduling.ts
    • Feature: Schedule future sessions
    • Feature: Recurring session reminders
    • Feature: Calendar integration
    • Feature: Notification scheduling
    • Acceptance: Sessions can be scheduled
  • 22.2.5.6 [High/M] Create session management React hooks

    • File: libs/meditation/session/src/hooks.ts
    • Hook: useSessionManager()
    • Hook: useCurrentSession()
    • Hook: useSessionState()
    • Acceptance: React integration hooks work

22.2.6 Offline Content Support#

  • 22.2.6.1 [High/L] Create offline support core library

    • File: libs/meditation/offline/src/index.ts
    • Project: @oshun/meditation-offline
    • Export: OfflineManager class
    • Export: Download types and interfaces
    • Acceptance: Library compiles and exports correctly
  • 22.2.6.2 [High/XL] Implement OfflineManager class

    • File: libs/meditation/offline/src/manager.ts
    • Method: download(content: DownloadableContent): Promise<void>
    • Method: cancelDownload(contentId: string): void
    • Method: removeDownload(contentId: string): Promise<void>
    • Method: getDownloads(): Promise<DownloadedContent[]>
    • Method: getDownloadStatus(contentId: string): DownloadStatus
    • Method: getStorageUsage(): Promise<StorageInfo>
    • Method: clearAllDownloads(): Promise<void>
    • Events: onDownloadProgress, onDownloadComplete, onDownloadError
    • Acceptance: Full offline download management
  • 22.2.6.3 [High/L] Implement download queue system

    • File: libs/meditation/offline/src/queue.ts
    • Feature: Queue multiple downloads
    • Feature: Priority ordering
    • Feature: Concurrent download limit
    • Feature: Retry failed downloads
    • Feature: Pause/resume all downloads
    • Acceptance: Download queue works reliably
  • 22.2.6.4 [High/M] Implement storage management

    • File: libs/meditation/offline/src/storage.ts
    • Feature: Track storage usage
    • Feature: Storage limit configuration
    • Feature: Auto-cleanup old downloads
    • Feature: Storage warning notifications
    • Acceptance: Storage managed within limits
  • 22.2.6.5 [High/M] Implement content versioning for downloads

    • File: libs/meditation/offline/src/versioning.ts
    • Feature: Track content versions
    • Feature: Update notifications
    • Feature: Background update downloads
    • Feature: Version conflict resolution
    • Acceptance: Downloaded content stays current
  • 22.2.6.6 [Medium/M] Implement smart download suggestions

    • File: libs/meditation/offline/src/suggestions.ts
    • Feature: Suggest downloads based on usage
    • Feature: Wi-Fi only download option
    • Feature: Auto-download favorites
    • Feature: Auto-download course progress
    • Acceptance: Smart download suggestions work
  • 22.2.6.7 [High/M] Create offline support React hooks

    • File: libs/meditation/offline/src/hooks.ts
    • Hook: useOfflineManager()
    • Hook: useDownloadStatus(contentId)
    • Hook: useDownloadedContent()
    • Hook: useStorageInfo()
    • Acceptance: React integration hooks work

22.3 Tara UI Component Library (@tara/ui)#

22.3.1 Design System Foundation#

  • 22.3.1.1 [High/L] Create Tara design tokens

    • File: libs/tara/ui/src/tokens/
    • Tokens: Colors (primary, secondary, accent, semantic)
    • Tokens: Typography (fonts, sizes, weights, line heights)
    • Tokens: Spacing (scale from 0 to 96)
    • Tokens: Border radius, shadows, transitions
    • Tokens: Breakpoints for responsive design
    • Theme: Light and dark mode tokens
    • Acceptance: Complete design token system
  • 22.3.1.2 [High/M] Define Tara color palette

    • File: libs/tara/ui/src/tokens/colors.ts
    • Primary: Soft blues (#7CB9E8, #6CA0DC, #5B92E5)
    • Secondary: Gentle greens (#90EE90, #98FB98, #8FBC8F)
    • Accent: Warm gold (#FFD700, #FFCC00, #F4C430)
    • Neutral: Grays for text and backgrounds
    • Semantic: Success, warning, error, info
    • Dark mode: Inverted palette
    • Acceptance: Color palette defined and documented
  • 22.3.1.3 [High/M] Define Tara typography system

    • File: libs/tara/ui/src/tokens/typography.ts
    • Font: Primary (e.g., Inter, SF Pro)
    • Font: Display/heading (e.g., Playfair, Cormorant)
    • Scale: Display, H1-H6, body, caption, overline
    • Weights: Regular, medium, semibold, bold
    • Acceptance: Typography system defined
  • 22.3.1.4 [High/M] Create Tara theme provider

    • File: libs/tara/ui/src/theme/provider.tsx
    • Component: TaraThemeProvider
    • Feature: Light/dark mode toggle
    • Feature: System preference detection
    • Feature: Theme persistence
    • Acceptance: Theme provider works across apps
  • 22.3.1.5 [High/M] Create Tara global styles

    • File: libs/tara/ui/src/styles/global.css
    • Styles: CSS reset/normalize
    • Styles: Base typography
    • Styles: Focus states
    • Styles: Scrollbar styling
    • Acceptance: Global styles applied consistently

22.3.2 Core UI Components ✅#

  • 22.3.2.1 [High/L] Create Button component

    • File: libs/tara/ui/src/components/Button/
    • Variants: Primary, secondary, tertiary, ghost
    • Sizes: Small, medium, large
    • States: Default, hover, active, disabled, loading
    • Features: Icon support, full-width option
    • Acceptance: Button component with all variants
  • 22.3.2.2 [High/M] Create IconButton component

    • File: libs/tara/ui/src/components/IconButton/
    • Variants: Primary, secondary, ghost
    • Sizes: Small, medium, large
    • Shapes: Circle, rounded square
    • Acceptance: Icon button component complete
  • 22.3.2.3 [High/L] Create Typography components

    • File: libs/tara/ui/src/components/Typography/
    • Components: Heading, Text, Label, Caption
    • Props: Variant, color, align, truncate
    • Acceptance: Typography components complete
  • 22.3.2.4 [High/M] Create Card component

    • File: libs/tara/ui/src/components/Card/
    • Variants: Elevated, outlined, filled
    • Features: Pressable option, loading state
    • Subcomponents: CardHeader, CardBody, CardFooter
    • Acceptance: Card component complete
  • 22.3.2.5 [High/M] Create Input component

    • File: libs/tara/ui/src/components/Input/
    • Types: Text, email, password, search
    • States: Default, focus, error, disabled
    • Features: Icon prefix/suffix, clear button
    • Acceptance: Input component complete
  • 22.3.2.6 [High/M] Create Modal/Dialog component

    • File: libs/tara/ui/src/components/Modal/
    • Variants: Alert, confirm, custom content
    • Features: Backdrop, close button, animations
    • Features: Trap focus, escape to close
    • Acceptance: Modal component complete
  • 22.3.2.7 [High/M] Create BottomSheet component

    • File: libs/tara/ui/src/components/BottomSheet/
    • Features: Draggable handle
    • Features: Snap points
    • Features: Backdrop
    • Features: Gesture to dismiss
    • Acceptance: Bottom sheet component complete
  • 22.3.2.8 [Medium/M] Create Toast/Snackbar component

    • File: libs/tara/ui/src/components/Toast/
    • Variants: Info, success, warning, error
    • Features: Auto-dismiss, action button
    • Features: Queue multiple toasts
    • Acceptance: Toast component complete
  • 22.3.2.9 [Medium/M] Create Avatar component

    • File: libs/tara/ui/src/components/Avatar/
    • Sources: Image, initials, icon
    • Sizes: XS, S, M, L, XL
    • Features: Loading state, fallback
    • Acceptance: Avatar component complete
  • 22.3.2.10 [Medium/M] Create Badge component

    • File: libs/tara/ui/src/components/Badge/
    • Variants: Count, dot, status
    • Positions: Top-right, top-left, inline
    • Acceptance: Badge component complete
  • 22.3.2.11 [Medium/M] Create Chip/Tag component

    • File: libs/tara/ui/src/components/Chip/
    • Variants: Filled, outlined
    • Features: Dismissible, selectable
    • Acceptance: Chip component complete
  • 22.3.2.12 [Medium/M] Create Divider component

    • File: libs/tara/ui/src/components/Divider/
    • Orientation: Horizontal, vertical
    • Features: With label
    • Acceptance: Divider component complete

22.3.3 Navigation Components#

  • 22.3.3.1 [High/L] Create TabBar component

    • File: libs/tara/ui/src/components/TabBar/
    • Type: Bottom navigation tabs
    • Features: Icon + label, badge support
    • Features: Active indicator animation
    • Acceptance: Tab bar component complete
  • 22.3.3.2 [High/M] Create Header/AppBar component

    • File: libs/tara/ui/src/components/Header/
    • Features: Title, back button, actions
    • Features: Large title collapse on scroll
    • Features: Search bar integration
    • Acceptance: Header component complete
  • 22.3.3.3 [High/M] Create SegmentedControl component

    • File: libs/tara/ui/src/components/SegmentedControl/
    • Features: Multiple segments
    • Features: Animated selection indicator
    • Acceptance: Segmented control complete
  • 22.3.3.4 [Medium/M] Create Breadcrumb component

    • File: libs/tara/ui/src/components/Breadcrumb/
    • Features: Clickable items
    • Features: Truncation for long paths
    • Acceptance: Breadcrumb component complete

22.3.4 Meditation-Specific Components#

  • 22.3.4.1 [High/XL] Create MeditationCard component

    • File: libs/tara/ui/src/components/MeditationCard/
    • Content: Thumbnail, title, duration, teacher
    • Content: Category badge, premium indicator
    • Content: Download status, progress indicator
    • Features: Pressable, context menu
    • Acceptance: Meditation card complete
  • 22.3.4.2 [High/XL] Create AudioPlayer component

    • File: libs/tara/ui/src/components/AudioPlayer/
    • Controls: Play/pause, seek bar, time display
    • Controls: Speed control, volume
    • Features: Mini player mode
    • Features: Full screen player mode
    • Features: Background artwork
    • Acceptance: Audio player UI complete
  • 22.3.4.3 [High/L] Create MiniPlayer component

    • File: libs/tara/ui/src/components/MiniPlayer/
    • Content: Current track info
    • Controls: Play/pause, close
    • Features: Expandable to full player
    • Features: Swipe to dismiss
    • Acceptance: Mini player complete
  • 22.3.4.4 [High/XL] Create TimerDisplay component

    • File: libs/tara/ui/src/components/TimerDisplay/
    • Display: Large countdown/countup
    • Display: Progress ring
    • Display: Phase indicator
    • Features: Animated transitions
    • Acceptance: Timer display complete
  • 22.3.4.5 [High/XL] Create BreathingVisualizer component

    • File: libs/tara/ui/src/components/BreathingVisualizer/
    • Visual: Expanding/contracting circle
    • Visual: Phase text (inhale, hold, exhale)
    • Visual: Progress indicator
    • Features: Smooth animations
    • Features: Customizable colors
    • Acceptance: Breathing visualizer complete
  • 22.3.4.6 [High/L] Create StreakDisplay component

    • File: libs/tara/ui/src/components/StreakDisplay/
    • Display: Current streak count
    • Display: Flame/fire icon animation
    • Display: Weekly calendar view
    • Features: Streak milestone celebration
    • Acceptance: Streak display complete
  • 22.3.4.7 [High/M] Create ProgressChart component

    • File: libs/tara/ui/src/components/ProgressChart/
    • Charts: Weekly bar chart
    • Charts: Monthly calendar heatmap
    • Charts: Trend line
    • Acceptance: Progress charts complete
  • 22.3.4.8 [High/M] Create CourseProgress component

    • File: libs/tara/ui/src/components/CourseProgress/
    • Display: Course completion percentage
    • Display: Lesson list with check marks
    • Display: Next lesson highlight
    • Acceptance: Course progress complete
  • 22.3.4.9 [Medium/M] Create TeacherCard component

    • File: libs/tara/ui/src/components/TeacherCard/
    • Content: Photo, name, bio excerpt
    • Content: Meditation count, specialty
    • Acceptance: Teacher card complete
  • 22.3.4.10 [Medium/M] Create AchievementBadge component

    • File: libs/tara/ui/src/components/AchievementBadge/
    • Display: Badge icon, name
    • States: Locked, unlocked, new
    • Features: Unlock animation
    • Acceptance: Achievement badge complete
  • 22.3.4.11 [Medium/M] Create SoundMixer component

    • File: libs/tara/ui/src/components/SoundMixer/
    • Controls: Multiple volume sliders
    • Display: Sound icons and labels
    • Features: Master volume
    • Acceptance: Sound mixer complete
  • 22.3.4.12 [Medium/M] Create SessionComplete component

    • File: libs/tara/ui/src/components/SessionComplete/
    • Display: Session summary
    • Display: Statistics earned
    • Display: Share prompt
    • Features: Celebration animation
    • Acceptance: Session complete screen

22.3.5 Layout Components#

  • 22.3.5.1 [High/M] Create SafeAreaView wrapper

    • File: libs/tara/ui/src/components/SafeArea/
    • Feature: Handles notch, home indicator
    • Feature: Keyboard avoidance
    • Acceptance: Safe area wrapper complete
  • 22.3.5.2 [High/M] Create ScrollView with refresh

    • File: libs/tara/ui/src/components/ScrollView/
    • Features: Pull to refresh
    • Features: Scroll to top
    • Features: Infinite scroll loading
    • Acceptance: Enhanced scroll view complete
  • 22.3.5.3 [High/M] Create Grid/List layout components

    • File: libs/tara/ui/src/components/Grid/
    • Layouts: List, 2-column grid, carousel
    • Features: Responsive breakpoints
    • Acceptance: Layout components complete
  • 22.3.5.4 [Medium/M] Create Skeleton loading components

    • File: libs/tara/ui/src/components/Skeleton/
    • Components: Text skeleton, card skeleton
    • Components: Avatar skeleton, image skeleton
    • Features: Shimmer animation
    • Acceptance: Skeleton components complete

22.3.6 Animation & Transitions#

  • 22.3.6.1 [High/L] Create animation primitives

    • File: libs/tara/ui/src/animations/
    • Animations: Fade in/out
    • Animations: Slide up/down/left/right
    • Animations: Scale, rotate
    • Library: React Native Reanimated or Framer Motion
    • Acceptance: Animation primitives work
  • 22.3.6.2 [High/M] Create page transition animations

    • File: libs/tara/ui/src/animations/transitions.tsx
    • Transitions: Stack push/pop
    • Transitions: Modal present/dismiss
    • Transitions: Tab switch
    • Acceptance: Page transitions smooth
  • 22.3.6.3 [Medium/M] Create micro-interaction animations

    • File: libs/tara/ui/src/animations/micro.tsx
    • Animations: Button press
    • Animations: Toggle switch
    • Animations: Like/favorite heart
    • Animations: Achievement unlock
    • Acceptance: Micro-interactions polished

22.4 Tara Content Management (@tara/content)#

22.4.1 Content Data Models#

  • 22.4.1.1 [High/L] Define meditation content types

    • File: libs/tara/content/src/types/meditation.ts
    • Type: Meditation (id, title, description, duration, audio, teacher, etc.)
    • Type: MeditationType enum (guided, unguided, sleep, focus, etc.)
    • Type: MeditationCategory (stress, sleep, focus, anxiety, etc.)
    • Type: AudioTrack (url, duration, format, size)
    • Acceptance: Complete meditation type definitions
  • 22.4.1.2 [High/L] Define course and lesson types

    • File: libs/tara/content/src/types/course.ts
    • Type: Course (id, title, description, lessons, teacher, etc.)
    • Type: Lesson (id, title, description, meditation, order)
    • Type: CourseProgress (completed lessons, current lesson)
    • Acceptance: Complete course type definitions
  • 22.4.1.3 [High/M] Define teacher types

    • File: libs/tara/content/src/types/teacher.ts
    • Type: Teacher (id, name, bio, photo, meditations, courses)
    • Type: TeacherProfile (extended bio, credentials, social)
    • Acceptance: Teacher types defined
  • 22.4.1.4 [High/M] Define collection and program types

    • File: libs/tara/content/src/types/collection.ts
    • Type: Collection (curated meditations)
    • Type: Program (structured multi-day program)
    • Type: DailyContent (daily meditation recommendation)
    • Acceptance: Collection types defined
  • 22.4.1.5 [Medium/M] Define sound and ambient types

    • File: libs/tara/content/src/types/sound.ts
    • Type: AmbientSound (rain, ocean, forest, etc.)
    • Type: BackgroundMusic (meditation music tracks)
    • Type: BellSound (timer bells)
    • Acceptance: Sound types defined

22.4.2 Content API Client#

  • 22.4.2.1 [High/XL] Create content API client ✅

    • File: libs/tara/content/src/api/client.ts
    • Method: getMeditations(filters): Promise<Meditation[]>
    • Method: getMeditation(id): Promise<Meditation>
    • Method: getCourses(): Promise<Course[]>
    • Method: getCourse(id): Promise<Course>
    • Method: getTeachers(): Promise<Teacher[]>
    • Method: getTeacher(id): Promise<Teacher>
    • Method: getDailyContent(): Promise<DailyContent>
    • Method: search(query): Promise<SearchResults>
    • Acceptance: Content API client complete
  • 22.4.2.2 [High/L] Implement content caching layer ✅

    • File: libs/tara/content/src/cache/
    • Feature: In-memory cache for content metadata
    • Feature: Persistent cache for offline access
    • Feature: Cache invalidation strategy
    • Feature: Stale-while-revalidate pattern
    • Acceptance: Caching reduces API calls
  • 22.4.2.3 [High/M] Implement content filtering and sorting

    • File: libs/tara/content/src/filters/
    • Filters: By category, duration, teacher, type
    • Filters: By premium/free, downloaded
    • Sorting: Popular, recent, duration, alphabetical
    • Acceptance: Filtering and sorting work
    • Completed: Core filter utilities, meditation filters, course filters with presets
  • 22.4.2.4 [High/M] Implement content search

    • File: libs/tara/content/src/search/
    • Feature: Full-text search
    • Feature: Fuzzy matching
    • Feature: Search suggestions
    • Feature: Recent searches
    • Acceptance: Search functionality works
    • Completed: Search engine, tokenizer, matcher, suggestions, spell correction

22.4.3 Content Hooks#

  • 22.4.3.1 [High/M] Create meditation content hooks

    • File: libs/tara/content/src/hooks/meditations.ts
    • Hook: useMeditations(filters)
    • Hook: useMeditation(id)
    • Hook: useFeaturedMeditations()
    • Hook: useRecentMeditations()
    • Acceptance: Meditation hooks work
    • Completed: useMeditations, useInfiniteMeditations, useMeditation, useLazyMeditation, useFeaturedMeditations, useRecentMeditations, useMeditationsByCategory, useMeditationsByTeacher, useQuickMeditations, useFreeMeditations
  • 22.4.3.2 [High/M] Create course content hooks

    • File: libs/tara/content/src/hooks/courses.ts
    • Hook: useCourses()
    • Hook: useCourse(id)
    • Hook: useCourseProgress(courseId)
    • Acceptance: Course hooks work
    • Completed: useCourses, useInfiniteCourses, useCourse, useLazyCourse, useCourseProgress, useCoursesByDifficulty, useCoursesByFormat, useCoursesByTeacher, useFeaturedCourses, useFreeCourses
  • 22.4.3.3 [High/M] Create teacher content hooks

    • File: libs/tara/content/src/hooks/teachers.ts
    • Hook: useTeachers()
    • Hook: useTeacher(id)
    • Hook: useTeacherMeditations(teacherId)
    • Acceptance: Teacher hooks work
    • Completed: useTeachers, useInfiniteTeachers, useTeacher, useLazyTeacher, useTeacherMeditations, useTeacherCourses, useTeacherContent, useTeachersBySpecialty, useTeachersByCategory, useFeaturedTeachers, useVerifiedTeachers
  • 22.4.3.4 [Medium/M] Create collection and program hooks

    • File: libs/tara/content/src/hooks/collections.ts
    • Hook: useCollections()
    • Hook: useCollection(id)
    • Hook: usePrograms()
    • Hook: useDailyContent()
    • Acceptance: Collection hooks work
    • Completed: useCollections, useCollection, useLazyCollection, useInfiniteCollections, usePrograms, useProgram, useLazyProgram, useInfinitePrograms, useProgramProgress, useDailyContent, useLazyDailyContent

22.5 Tara Web Application (apps/tara/web)#

22.5.1 Next.js Project Setup ✅#

  • 22.5.1.1 [High/L] Initialize Next.js project

    • Directory: apps/tara/web/
    • Framework: Next.js 14+ with App Router
    • Language: TypeScript
    • Styling: Tailwind CSS
    • File: project.json with Nx configuration
    • Acceptance: Next.js app runs with nx dev @tara/web
  • 22.5.1.2 [High/M] Configure Next.js app settings

    • File: apps/tara/web/next.config.js
    • Config: Image optimization
    • Config: Environment variables
    • Config: API rewrites
    • Config: Security headers
    • Acceptance: Next.js configured correctly
  • 22.5.1.3 [High/M] Set up Tailwind CSS with Tara theme

    • File: apps/tara/web/tailwind.config.js
    • Config: Import Tara design tokens
    • Config: Custom color palette (meditation-themed)
    • Config: Typography plugin
    • Config: Breathing animations
    • Acceptance: Tailwind uses Tara theme
  • 22.5.1.4 [High/S] Create app layout structure

    • File: apps/tara/web/src/app/layout.tsx
    • File: apps/tara/web/src/app/[locale]/layout.tsx
    • Structure: Root layout with providers
    • Structure: Internationalization support (7 locales)
    • Structure: Toast notifications
    • Acceptance: Layout structure in place
  • 22.5.1.5 [High/M] Set up PWA configuration

    • File: apps/tara/web/public/manifest.json
    • File: apps/tara/web/public/sw.js
    • Config: App name, icons, theme color
    • Config: Start URL, display mode
    • Feature: Service worker for offline caching
    • Acceptance: Installable as PWA

22.5.2 Authentication & User Management#

  • 22.5.2.1 [High/XL] Implement authentication system

    • Directory: apps/tara/web/src/app/[locale]/(auth)/
    • Pages: /login, /signup, /forgot-password, /reset-password
    • Pages: /callback (OAuth), /verify-email
    • Methods: Email/password, magic link
    • Methods: Google OAuth, Apple Sign In
    • Feature: Remember me, session management
    • Implemented: Full auth forms with validation
    • Implemented: OAuth callback handling
    • Acceptance: Full authentication flow works ✓
  • 22.5.2.2 [High/L] Create authentication context and hooks

    • Directory: apps/tara/web/src/lib/auth/
    • Files: types.ts, api.ts, store.ts, context.tsx, index.ts
    • Context: AuthProvider with user state
    • Hook: useAuth() - current user, loading, error
    • Hook: useRequireAuth() - redirect if not logged in
    • Hook: useRequirePremium() - redirect if not premium
    • Hook: useGuestOnly() - redirect if authenticated
    • Store: Zustand with persistence and token refresh
    • Acceptance: Auth state management works ✓
  • 22.5.2.3 [High/M] Implement user profile pages

    • Directory: apps/tara/web/src/app/[locale]/(app)/settings/
    • Pages: /settings/profile, /settings/preferences
    • Pages: /settings/notifications, /settings/security
    • Pages: /settings/subscription
    • Features: Avatar upload, name edit, timezone
    • Features: Password change, session management
    • Features: Notification preferences, TOTP two-factor controls
    • Acceptance: Profile management works ✓
  • 22.5.2.4 [High/M] Implement subscription management ✓ COMPLETE

    • Pages: /subscription, /subscription/plans, /subscription/billing
    • Features: View current plan
    • Features: Upgrade/downgrade
    • Features: Billing history
    • Integration: Stripe or similar
    • Acceptance: Subscription management works ✓
    • Implementation:
      • Layout: apps/tara/web/src/app/[locale]/(app)/subscription/layout.tsx
        • Tab navigation with Overview, Plans, Billing tabs
        • Responsive header with page title and back-to-app link
      • Main Page: apps/tara/web/src/app/[locale]/(app)/subscription/page.tsx
        • Current plan card with tier display, status badges, billing details
        • Usage metrics section with progress indicators
        • Quick actions grid for premium vs free users
        • Stats summary showing meditation journey progress
        • Cancel subscription flow with confirmation
      • Plans Page: apps/tara/web/src/app/[locale]/(app)/subscription/plans/page.tsx
        • Four tier plans: Free, Basic, Premium, Lifetime
        • Monthly/yearly billing toggle with savings indicator
        • Plan comparison feature grid
        • FAQ accordion section with 6 common questions
        • Checkout modal with confirmation flow
        • 30-day money-back guarantee section
      • Billing Page: apps/tara/web/src/app/[locale]/(app)/subscription/billing/page.tsx
        • Three tabs: History, Payment Methods, Invoices
        • Transaction history with status indicators
        • Payment method management (add/remove/set default)
        • Card brand icons (Visa, Mastercard, PayPal)
        • Invoice table with download/view actions
        • Year filter for invoice history
        • Add payment method modal with card form

22.5.3 Core Pages & Routes#

  • 22.5.3.1 [High/XL] Create home/dashboard page

    • Route: / (authenticated) or landing page (unauthenticated)
    • Content: Daily meditation recommendation
    • Content: Continue where you left off
    • Content: Streak display
    • Content: Quick actions (timer, breathing)
    • Content: Featured content
    • Acceptance: Home page complete
    • Implemented: apps/tara/web/src/app/[locale]/page.tsx - Client-side home page with:
      • LandingPage component for unauthenticated users (hero, features, quick actions, CTA)
      • DashboardPage component for authenticated users (greeting, streak, daily meditation, continue watching, quick actions, recommendations, courses, quote)
      • Uses @tara/ui components (StreakDisplay, MeditationCard)
      • Bottom navigation for mobile
      • Full i18n support via next-intl
  • 22.5.3.2 [High/XL] Create meditation browse page

    • Route: /meditate (legacy alias: /meditations)
    • Features: Category filters
    • Features: Duration filters
    • Features: Search
    • Features: Sort options
    • Layout: Grid view, list view toggle
    • Acceptance: Browse page complete
    • Implemented: apps/tara/web/src/app/[locale]/(app)/meditate/page.tsx - Full-featured meditation browse page with:
      • Search functionality with clear button
      • Category filter chips (all, stress, sleep, focus, anxiety, morning, evening, breathing, body, gratitude)
      • Duration filters (all, 5-10min, 10-20min, 20+ min)
      • Sort options (popular, recent, duration, A-Z)
      • Grid/List view toggle
      • Results count and empty state
      • MeditationCard integration with all metadata
      • Bottom navigation
      • Responsive design
  • 22.5.3.3 [High/XL] Create meditation detail page

    • Route: /meditate/[id] (legacy alias: /meditations/[id])
    • Content: Full description, teacher info
    • Content: Duration, category badges
    • Actions: Play, download, favorite
    • Related: Similar meditations
    • Acceptance: Detail page complete
    • Implemented: apps/tara/web/src/app/[locale]/(app)/meditate/[id]/page.tsx - Full-featured meditation detail page with:
      • Hero image with gradient overlay and back button
      • Premium/New/Category/Difficulty badges
      • Star rating display with review count
      • Duration and play count stats
      • Action buttons (Play, Download, Favorite, Share)
      • Premium upgrade banner for locked content
      • Full description, benefits list, preparation instructions
      • Teacher card with link to profile
      • Tags with search links
      • Related meditations grid
      • Fixed bottom play button bar
      • Premium content gate integration
  • 22.5.3.4 [High/XL] Create meditation player page ✅ COMPLETE

    • Route: /play/[id]
    • Components: Full audio player
    • Components: Background image/animation
    • Components: Progress tracking
    • Features: Sleep timer
    • Features: Fullscreen mode
    • Acceptance: Player page complete
    • Implementation (commit 5cc78b1c):
      • Full-screen meditation player at /apps/tara/web/src/app/[locale]/(app)/play/[id]/page.tsx
      • HTML5 audio player with play/pause/seek controls
      • Progress bar with touch-friendly dragging and time display
      • Breathing circle animation that pulses during playback
      • Sleep timer modal with configurable durations (5-60 min)
      • Playback speed control (0.5x to 2x)
      • Fullscreen mode toggle with proper API handling
      • Auto-hiding controls after 5s inactivity
      • Session completion overlay with restart/close options
      • Background blur effect from meditation thumbnail
  • 22.5.3.5 [High/XL] Create courses page ✅ COMPLETE

    • Route: /courses
    • Content: Course cards with progress
    • Features: Filter by category
    • Features: Sort by popularity, recent
    • Acceptance: Courses page complete
    • Implementation (commit 32bb39b5):
      • Courses browse page at /apps/tara/web/src/app/[locale]/(app)/courses/page.tsx
      • Course cards with progress indicators for enrolled courses
      • Grid and list view toggle
      • Category filters (beginner, stress, sleep, mindfulness, etc.)
      • Sort options (popular, recent, duration, alphabetical)
      • Search functionality with debounced input
      • Continue Learning section for in-progress courses
      • Premium content indicators and lock icons
      • Responsive design with mobile bottom navigation
  • 22.5.3.6 [High/XL] Create course detail page ✅ COMPLETE

    • Route: /courses/[id]
    • Content: Course description, teacher
    • Content: Lesson list with progress
    • Content: Course duration, lesson count
    • Actions: Start course, continue course
    • Acceptance: Course detail complete
    • Implementation (commit d02fa7d9):
      • Course detail page at /apps/tara/web/src/app/[locale]/(app)/courses/[id]/page.tsx
      • Hero section with course image, title, teacher, rating
      • Course stats bar (lessons, duration, students, difficulty)
      • Progress tracker for enrolled users
      • Three-tab interface: Overview, Curriculum, Reviews
      • CourseProgress component integration with collapsible sections
      • Learning outcomes and requirements lists
      • Teacher card with bio and specialties
      • Review cards with star ratings
      • Premium gate for locked courses
      • Start/Continue course action buttons
  • 22.5.3.7 [High/L] Create timer page ✅ COMPLETE

    • Route: /timer
    • Features: Duration presets
    • Features: Custom duration
    • Features: Bell selection
    • Features: Ambient sounds
    • Features: Full timer interface
    • Acceptance: Timer page complete
    • Implementation (commit 5522bae9):
      • Timer page at /apps/tara/web/src/app/[locale]/(app)/timer/page.tsx
      • Duration presets (5, 10, 15, 20, 30, 45, 60 minutes)
      • Custom duration input up to 3 hours
      • Start/End bell selection with 6 options + preview
      • Interval bell settings (none, 1, 2, 5, 10 min)
      • Ambient sound mixer with 8 nature sounds
      • Individual volume controls per sound
      • Full-screen timer display with progress ring
      • Play/Pause/Stop controls
      • Add time during session (+1, +5, +10 min)
      • Session complete screen with stats
  • 22.5.3.8 [High/L] Create breathing exercises page ✅ COMPLETE

    • Route: /breathing
    • Content: Breathing exercise list
    • Features: Pattern selection
    • Features: Duration/repetition settings
    • Features: Full breathing interface
    • Acceptance: Breathing page complete
  • 22.5.3.9 [High/L] Create progress/stats page ✅ COMPLETE

    • Route: /progress
    • Content: Streak calendar
    • Content: Weekly/monthly charts
    • Content: Total time, sessions
    • Content: Achievements list
    • Acceptance: Progress page complete
  • 22.5.3.10 [High/M] Create teachers page ✅ COMPLETE

    • Route: /teachers
    • Content: Teacher cards
    • Features: Search teachers
    • Acceptance: Teachers page complete
  • 22.5.3.11 [High/M] Create teacher detail page ✅ COMPLETE

    • Route: /teachers/[id]
    • Content: Full bio, credentials
    • Content: Their meditations
    • Content: Their courses
    • Acceptance: Teacher detail complete
  • 22.5.3.12 [Medium/M] Create favorites/library page ✅ COMPLETE

    • Route: /library
    • Tabs: Favorites, downloads, history
    • Features: Manage favorites
    • Features: Manage downloads
    • Acceptance: Library page complete
  • 22.5.3.13 [Medium/M] Create search page ✅ COMPLETE

    • Route: /search
    • Features: Universal search
    • Features: Recent searches
    • Features: Search suggestions
    • Features: Results by type
    • Acceptance: Search page complete
  • 22.5.3.14 [Medium/M] Create settings page ✅ COMPLETE

    • Route: /settings
    • Sections: Account, notifications, playback
    • Sections: Downloads, privacy, about
    • Acceptance: Settings page complete

22.5.4 Web-Specific Features#

  • 22.5.4.1 [High/M] Implement responsive design ✓ COMPLETE

    • Breakpoints: Mobile, tablet, desktop
    • Layout: Sidebar navigation on desktop
    • Layout: Bottom tabs on mobile
    • Acceptance: Responsive across all sizes ✓
    • Implementation:
      • Layout Component: apps/tara/web/src/components/layout/AppLayout.tsx
        • Responsive sidebar (desktop lg:) with collapsible state
        • Bottom tab navigation (mobile <lg)
        • Sidebar includes: Home, Meditate, Courses, Timer, Breathing, Progress, Library, Search, Settings
        • Mobile bottom nav includes: Home, Meditate, Courses, Timer, Settings
        • User profile card in sidebar
        • Premium content lock indicators
        • Persisted collapse state in localStorage
        • SVG icons with filled/outline variants for active state
      • Layout Index: apps/tara/web/src/components/layout/index.ts
      • App Layout Updated: apps/tara/web/src/app/[locale]/(app)/layout.tsx
        • Automatically wraps pages with responsive layout
        • Excludes pages with own layouts: settings, subscription, play
      • Pages Cleaned Up (removed inline bottom nav):
        • meditate/page.tsx, courses/page.tsx, courses/[id]/page.tsx
        • timer/page.tsx, breathing/page.tsx, progress/page.tsx
        • teachers/page.tsx, teachers/[id]/page.tsx
        • library/page.tsx, search/page.tsx
  • 22.5.4.2 [High/M] Implement keyboard navigation ✓ COMPLETE

    • Feature: Tab navigation
    • Feature: Keyboard shortcuts (space to play/pause)
    • Feature: Focus indicators
    • Acceptance: Keyboard accessible
    • Implementation:
      • Created useKeyboardShortcuts hook with specialized hooks for media, modal, timer, and navigation
      • Created useFocusTrap hook for modal focus management
      • Added enhanced focus indicators in globals.css
      • Added skip link component for keyboard users
      • Updated media player with keyboard shortcuts (Space, Arrow keys, Escape, etc.)
      • Updated timer page with keyboard shortcuts
      • Updated breathing page with keyboard shortcuts
      • Added ARIA attributes to navigation components
  • 22.5.4.3 [High/M] Implement SEO optimization ✓ COMPLETE

    • Feature: Meta tags for all pages
    • Feature: OpenGraph tags
    • Feature: Structured data (JSON-LD)
    • Feature: Sitemap generation
    • Acceptance: SEO optimized
    • Implementation:
      • Created lib/seo.ts with metadata utilities and JSON-LD schema generators
      • Created sitemap.ts for dynamic sitemap generation
      • Created robots.ts for robots.txt configuration
      • Created JsonLd component for structured data
      • Added global JSON-LD schemas (Organization, WebSite, MobileApplication)
      • Added page-specific metadata generation utilities
      • Added accessibility translations (skip link, ARIA labels)
  • 22.5.4.4 [Medium/M] Implement social sharing ✓ COMPLETE

    • Feature: Share meditation to social
    • Feature: Share progress/achievements
    • Feature: Invite friends
    • Acceptance: Social sharing works
    • Implementation:
      • Created lib/share.ts with sharing utilities and platform URL generators
      • Created useShare hook with platform-specific share methods
      • Created ShareModal component with platform buttons and copy link
      • Supports Twitter, Facebook, LinkedIn, WhatsApp, Telegram, Email
      • Includes Web Share API support for native mobile sharing
      • Content generators for meditations, courses, teachers, progress, achievements
      • Added share-related translations
  • 22.5.4.5 [Medium/M] Implement notification preferences ✓ COMPLETE

    • Feature: Browser push notifications
    • Feature: Email notification settings
    • Feature: Reminder scheduling
    • Acceptance: Notifications configurable
    • Implementation:
      • Created lib/notifications.ts with comprehensive notification service
      • Created useNotifications, useNotificationPermission, useReminder hooks
      • Enhanced notifications settings page with full UI
      • Push notification permission management and Web Push API support
      • Email notification frequency settings (instant/daily/weekly/never)
      • Reminder scheduling with day-of-week selection
      • Quiet hours configuration
      • Enhanced service worker with push notification handling
      • Added translations for all new notification features

22.6 Tara Mobile Application (apps/tara/mobile)#

22.6.1 React Native Project Setup#

  • 22.6.1.1 [High/XL] Initialize React Native project ✓ COMPLETE

    • Directory: apps/tara/mobile/
    • Framework: React Native with Expo SDK 51
    • Language: TypeScript
    • Navigation: Expo Router (file-based routing)
    • File: project.json with Nx configuration
    • Acceptance: App runs on iOS and Android simulators
    • Implementation:
      • Created project.json with start, build, lint, typecheck targets
      • Created package.json with all required dependencies
      • Created tsconfig.json with monorepo path aliases
      • Created babel.config.js and metro.config.js for bundler configuration
      • Created eas.json for EAS Build configuration
      • Set up file-based routing with expo-router
  • 22.6.1.2 [High/L] Configure Expo project ✓ COMPLETE

    • File: apps/tara/mobile/app.json
    • Config: App name, slug, version
    • Config: iOS bundle ID: com.tara.meditation
    • Config: Android package: com.tara.meditation
    • Config: Icons, splash screen
    • Acceptance: Expo config complete
    • Implementation:
      • Configured app.json with all required settings
      • Set up iOS background audio mode and remote notifications
      • Configured Android permissions and adaptive icon
      • Enabled typed routes experiment
  • 22.6.1.3 [High/M] Set up React Navigation ✓ COMPLETE

    • File: apps/tara/mobile/app/
    • Navigator: Bottom tab navigator with 5 tabs
    • Navigator: Stack navigators per tab via expo-router
    • Navigator: Modal stack for player
    • Acceptance: Navigation structure in place
    • Implementation:
      • Created root _layout.tsx with Stack navigator
      • Created (tabs)/_layout.tsx with bottom tab navigator
      • Created tab screens: index, meditate, timer, progress, profile
      • Created player/[id].tsx as fullscreen modal
      • Implemented blur tab bar effect for iOS
  • 22.6.1.4 [High/M] Configure native modules ✓ COMPLETE

    • Modules: expo-av for audio playback
    • Modules: Background audio via iOS/Android config
    • Modules: expo-notifications for push notifications
    • Modules: expo-haptics for haptic feedback
    • Acceptance: Native modules configured
    • Implementation:
      • Added expo-av, expo-notifications, expo-haptics
      • Added expo-blur, expo-linear-gradient, expo-image
      • Added expo-secure-store for secure storage
      • Configured permissions in app.json
  • 22.6.1.5 [High/M] Set up app theming ✓ COMPLETE

    • File: apps/tara/mobile/src/theme/
    • Feature: Light/dark mode
    • Feature: System preference sync
    • Feature: Theme persistence
    • Acceptance: Theming works on both platforms
    • Implementation:
      • Created comprehensive theme with colors, typography, spacing
      • Integrated with React Navigation theme provider
      • Added useColorScheme hook for system preference
      • Created StyleSheet factories for dark/light mode styles

22.6.2 iOS-Specific Configuration ✅#

  • 22.6.2.1 [High/L] Configure iOS project

    • File: apps/tara/mobile/app.json (Expo managed)
    • Config: Bundle identifier (com.tara.meditation)
    • Config: App name and icons
    • Config: Launch screen
    • Config: Capabilities (background audio, push notifications)
    • Config: Privacy manifests (NSPrivacyAccessedAPITypes)
    • Config: Entitlements (APNs, Apple Sign In, associated domains)
    • Acceptance: iOS project configured via Expo
  • 22.6.2.2 [High/M] Configure iOS background audio

    • File: apps/tara/mobile/app.json (UIBackgroundModes)
    • File: apps/tara/mobile/src/services/audio.ts
    • Capability: Audio background mode (staysActiveInBackground)
    • Capability: Remote control events
    • Feature: Now Playing info (via expo-av)
    • Feature: Control Center integration
    • Feature: Audio session management with interruption handling
    • Acceptance: Background audio configured for iOS
  • 22.6.2.3 [High/M] Configure iOS push notifications

    • File: apps/tara/mobile/src/services/notifications.ts
    • Config: APNs entitlements (aps-environment: production)
    • Config: Notification permissions with provisional support
    • Feature: Notification categories (DAILY_REMINDER, STREAK_REMINDER, etc.)
    • Feature: Rich notifications with actions and attachments
    • Feature: Deep linking from notifications
    • Acceptance: Push notifications configured for iOS
  • 22.6.2.4 [High/L] Configure iOS in-app purchases

    • File: apps/tara/mobile/src/services/purchases.ts
    • Config: RevenueCat SDK integration
    • Products: Monthly subscription (tara_premium_monthly)
    • Products: Annual subscription (tara_premium_annual)
    • Products: Lifetime purchase (tara_premium_lifetime)
    • Feature: Restore purchases
    • Feature: Subscription status sync
    • Feature: Promotional offers support
    • Acceptance: IAP configured via RevenueCat
  • 22.6.2.5 [High/M] Configure iOS App Store assets

    • File: apps/tara/mobile/store/ios/metadata.json
    • File: apps/tara/mobile/store/ios/README.md
    • Assets: Screenshot specifications for all device sizes
    • Assets: App preview video requirements
    • Content: Full App Store description
    • Content: Keywords, categories, age ratings
    • Content: Review notes and demo account info
    • Acceptance: App Store metadata template ready
  • 22.6.2.6 [Medium/M] Implement iOS-specific features

    • File: apps/tara/mobile/src/services/apple.ts
    • Feature: Haptic feedback (triggerHaptic, hapticSuccess, etc.)
    • Feature: Sign in with Apple authentication
    • Feature: App Tracking Transparency (iOS 14.5+)
    • Feature: expo-tracking-transparency integration
    • Note: Siri Shortcuts and Widgets require native module development
    • Acceptance: Core iOS-specific features implemented

22.6.3 Android-Specific Configuration ✅#

  • 22.6.3.1 [High/L] Configure Android project

    • File: apps/tara/mobile/app.json (Expo managed)
    • Config: Package name (com.tara.meditation)
    • Config: Adaptive icon with monochrome support
    • Config: Android 12+ splash screen with dark mode
    • Config: Deep link intent filters
    • Config: Blocked permissions for unnecessary features
    • Acceptance: Android project configured via Expo
  • 22.6.3.2 [High/M] Configure Android background audio

    • File: apps/tara/mobile/src/services/audio.ts
    • Config: Foreground service permission
    • Config: Audio session with duck other audio
    • Feature: Notification controls (via expo-av)
    • Feature: Lock screen controls (via expo-av)
    • Acceptance: Background audio configured for Android
  • 22.6.3.3 [High/M] Configure Android push notifications

    • File: apps/tara/mobile/src/services/android.ts
    • Config: google-services.json reference
    • Config: Notification channels (default, reminders, meditation, updates, achievements)
    • Feature: Notification customization
    • Feature: Channel-specific sounds and vibration
    • Acceptance: Push notifications configured for Android
  • 22.6.3.4 [High/L] Configure Android in-app purchases

    • File: apps/tara/mobile/src/services/purchases.ts
    • Config: RevenueCat with Google Play billing
    • Products: Monthly subscription (tara_premium_monthly)
    • Products: Annual subscription (tara_premium_annual)
    • Products: Lifetime purchase (tara_premium_lifetime)
    • Feature: Restore purchases
    • Acceptance: IAP configured via RevenueCat
  • 22.6.3.5 [High/M] Configure Play Store assets

    • File: apps/tara/mobile/store/android/metadata.json
    • File: apps/tara/mobile/store/android/README.md
    • Assets: Icon and graphic specifications
    • Assets: Screenshot requirements for phone/tablet
    • Content: Full Play Store description and metadata
    • Content: In-app product definitions
    • Content: Data safety declarations
    • Acceptance: Play Store metadata template ready
  • 22.6.3.6 [Medium/M] Implement Android-specific features

    • File: apps/tara/mobile/src/services/android.ts
    • Feature: Material You color detection (Android 12+)
    • Feature: App shortcuts definitions (static)
    • Feature: Google Sign In native module integration guard
    • Feature: Deep link parsing utilities
    • Feature: Battery optimization request
    • Note: Widgets require native module development
    • Acceptance: Core Android-specific features implemented

22.6.4 Mobile Core Screens ✅#

  • 22.6.4.1 [High/XL] Create Home screen

    • Screen: HomeScreen
    • Content: Daily meditation
    • Content: Continue meditation
    • Content: Streak display
    • Content: Quick actions
    • Content: Featured content carousel
    • Acceptance: Home screen complete
  • 22.6.4.2 [High/XL] Create Explore/Browse screen

    • Screen: ExploreScreen
    • Content: Category sections
    • Content: Featured collections
    • Content: New releases
    • Features: Pull to refresh
    • Acceptance: Explore screen complete
  • 22.6.4.3 [High/XL] Create Meditation Detail screen

    • Screen: MeditationDetailScreen
    • Content: Full details
    • Content: Teacher info
    • Actions: Play, download, favorite
    • Content: Related meditations
    • Acceptance: Detail screen complete
  • 22.6.4.4 [High/XL] Create Player screen

    • Screen: PlayerScreen
    • Components: Full audio controls
    • Components: Background visuals
    • Components: Progress bar
    • Features: Sleep timer
    • Features: Playback speed
    • Acceptance: Player screen complete
  • 22.6.4.5 [High/XL] Create Timer screen

    • Screen: TimerScreen
    • Components: Timer display
    • Components: Duration selector
    • Components: Sound selector
    • Features: Background operation
    • Acceptance: Timer screen complete
  • 22.6.4.6 [High/XL] Create Breathing screen

    • Screen: BreathingScreen
    • Components: Breathing visualizer
    • Components: Pattern selector
    • Components: Settings
    • Acceptance: Breathing screen complete
  • 22.6.4.7 [High/L] Create Courses screen

    • Screen: CoursesScreen
    • Content: Course list
    • Content: In-progress courses
    • Features: Filter and sort
    • Acceptance: Courses screen complete
  • 22.6.4.8 [High/L] Create Course Detail screen

    • Screen: CourseDetailScreen
    • Content: Course info
    • Content: Lesson list
    • Content: Progress indicator
    • Acceptance: Course detail complete
  • 22.6.4.9 [High/L] Create Progress screen

    • Screen: ProgressScreen
    • Content: Streak calendar
    • Content: Statistics
    • Content: Achievements
    • Acceptance: Progress screen complete
  • 22.6.4.10 [High/M] Create Profile screen

    • Screen: ProfileScreen
    • Content: User info
    • Content: Subscription status
    • Links: Settings, help, logout
    • Acceptance: Profile screen complete
  • 22.6.4.11 [High/M] Create Settings screen

    • Screen: SettingsScreen
    • Sections: Account, notifications
    • Sections: Playback, downloads
    • Sections: Privacy, about
    • Acceptance: Settings screen complete
  • 22.6.4.12 [Medium/M] Create Search screen

    • Screen: SearchScreen
    • Features: Search input
    • Features: Recent searches
    • Features: Results display
    • Acceptance: Search screen complete
  • 22.6.4.13 [Medium/M] Create Library/Downloads screen

    • Screen: LibraryScreen
    • Tabs: Favorites, downloads, history
    • Features: Manage downloads
    • Acceptance: Library screen complete

22.6.5 Mobile-Specific Features#

  • 22.6.5.1 [High/XL] Implement offline mode

    • Feature: Download meditations
    • Feature: Offline playback
    • Feature: Sync when online
    • Feature: Storage management UI
    • Acceptance: Full offline support
  • 22.6.5.2 [High/L] Implement push notifications

    • Notifications: Daily reminders
    • Notifications: Streak reminders
    • Notifications: New content
    • Feature: Notification preferences
    • Acceptance: Push notifications work
  • 22.6.5.3 [High/L] Implement deep linking

    • Links: Open specific meditation
    • Links: Open specific course
    • Links: Share links
    • Config: Universal links (iOS), App Links (Android)
    • Acceptance: Deep linking works
  • 22.6.5.4 [High/M] Implement mini player

    • Feature: Persistent mini player at bottom
    • Feature: Expand to full player
    • Feature: Continue across screens
    • Acceptance: Mini player works
  • 22.6.5.5 [Medium/M] Implement onboarding flow

    • Screens: Welcome, benefits
    • Screens: Preferences (goals, experience level)
    • Screens: Notification permission
    • Screens: Sign up prompt
    • Acceptance: Onboarding flow complete
  • 22.6.5.6 [Medium/M] Implement share functionality

    • Feature: Share meditation
    • Feature: Share progress
    • Feature: Share streak
    • Feature: Invite friends
    • Acceptance: Sharing works
  • 22.6.5.7 [Medium/M] Implement accessibility features

    • Feature: VoiceOver/TalkBack support
    • Feature: Dynamic type/font scaling
    • Feature: Reduce motion option
    • Feature: High contrast mode
    • Acceptance: Accessible to all users

22.7 Tara Backend API (apps/tara/api)#

22.7.1 API Project Setup#

  • 22.7.1.1 [High/L] Initialize API project

    • Directory: apps/tara/api/
    • Framework: Hono (TypeScript-first, OpenAPI-integrated)
    • Language: TypeScript
    • File: project.json with Nx configuration
    • Acceptance: API runs with nx serve @tara/api
  • 22.7.1.2 [High/M] Configure API server

    • File: apps/tara/api/src/app.ts
    • Config: Port, CORS, security headers
    • Config: Request logging
    • Config: Error handling
    • Acceptance: Server configuration complete (done in 22.7.1.1)
  • 22.7.1.3 [High/M] Set up database connection

    • Config: PostgreSQL connection using @oshun/database
    • Config: Connection pooling via pg Pool
    • Config: Drizzle-kit for migrations (drizzle.config.ts)
    • ORM: Drizzle ORM with comprehensive schema
    • Acceptance: Database connected ✓ (health endpoint shows healthy)
  • 22.7.1.4 [High/M] Set up Redis connection

    • Config: Redis client using @oshun/cache
    • Use: Session storage (key builders)
    • Use: Rate limiting (key builders)
    • Use: Caching (TTL constants)
    • Acceptance: Redis connected ✓ (health endpoint shows healthy)
  • 22.7.1.5 [High/M] Configure API documentation

    • Tool: OpenAPI/Swagger with @hono/zod-openapi
    • File: Auto-generated from routes
    • Endpoint: /api/docs
    • Acceptance: API docs available (done in 22.7.1.1)

22.7.2 Authentication Endpoints#

  • 22.7.2.1 [High/XL] Implement authentication endpoints ✓

    • Endpoint: POST /auth/register ✓
    • Endpoint: POST /auth/login ✓
    • Endpoint: POST /auth/logout ✓
    • Endpoint: POST /auth/refresh ✓
    • Endpoint: POST /auth/forgot-password ✓
    • Endpoint: POST /auth/reset-password ✓
    • Endpoint: POST /auth/verify-email ✓
    • Acceptance: Auth endpoints work ✓
  • 22.7.2.2 [High/L] Implement OAuth endpoints ✓

    • Endpoint: GET /auth/google ✓
    • Endpoint: GET /auth/google/callback ✓
    • Endpoint: GET /auth/apple ✓
    • Endpoint: POST /auth/apple/callback ✓
    • Acceptance: OAuth endpoints work ✓
  • 22.7.2.3 [High/M] Implement JWT token management ✓

    • Feature: Access token generation ✓
    • Feature: Refresh token rotation ✓
    • Feature: Token revocation ✓
    • Feature: Token blacklist (via @oshun/auth) ✓
    • Acceptance: JWT management complete ✓
  • 22.7.2.4 [High/M] Implement authentication middleware ✓

    • Middleware: JWT validation ✓
    • Middleware: User context injection ✓
    • Middleware: Rate limiting ✓
    • Acceptance: Auth middleware works ✓

22.7.3 User Endpoints#

  • 22.7.3.1 [High/L] Implement user profile endpoints ✓

    • Endpoint: GET /users/me ✓
    • Endpoint: PATCH /users/me ✓
    • Endpoint: DELETE /users/me ✓
    • Endpoint: POST /users/me/avatar ✓
    • Endpoint: DELETE /users/me/avatar ✓
    • Endpoint: POST /users/me/change-password ✓
    • Acceptance: User endpoints work ✓
  • 22.7.3.2 [High/M] Implement user settings endpoints

    • Endpoint: GET /users/me/settings
    • Endpoint: PATCH /users/me/settings
    • Settings: Notifications, playback, privacy
    • Acceptance: Settings endpoints work ✓
  • 22.7.3.3 [High/M] Implement user devices endpoints

    • Endpoint: GET /users/me/devices
    • Endpoint: POST /users/me/devices
    • Endpoint: PATCH /users/me/devices/:id
    • Endpoint: DELETE /users/me/devices/:id
    • Purpose: Push notification tokens
    • Acceptance: Device endpoints work ✓

22.7.4 Content Endpoints#

  • 22.7.4.1 [High/XL] Implement meditation endpoints

    • Endpoint: GET /meditations
    • Endpoint: GET /meditations/:id
    • Endpoint: GET /meditations/featured
    • Endpoint: GET /meditations/categories
    • Query: Filters, pagination, sorting
    • Acceptance: Meditation endpoints work ✓
  • 22.7.4.2 [High/L] Implement course endpoints

    • Endpoint: GET /courses
    • Endpoint: GET /courses/:id
    • Endpoint: GET /courses/:id/lessons
    • Endpoint: GET /courses/:id/lessons/:lessonId
    • Acceptance: Course endpoints work ✓
  • 22.7.4.3 [High/M] Implement teacher endpoints

    • Endpoint: GET /teachers
    • Endpoint: GET /teachers/:id
    • Endpoint: GET /teachers/:id/meditations
    • Endpoint: GET /teachers/:id/courses
    • Acceptance: Teacher endpoints work ✓
  • 22.7.4.4 [High/M] Implement collection endpoints

    • Endpoint: GET /collections
    • Endpoint: GET /collections/:id
    • Endpoint: GET /daily (as /collections/daily)
    • Acceptance: Collection endpoints work ✓
  • 22.7.4.5 [High/M] Implement search endpoint ✓

    • Endpoint: GET /search ✓
    • Query: q (search term) ✓
    • Query: type (meditation, course, teacher) ✓
    • Feature: Full-text search ✓
    • Acceptance: Search endpoint works ✓
  • 22.7.4.6 [Medium/M] Implement content audio endpoints ✓

    • Endpoint: GET /meditations/:id/audio ✓
    • Feature: Signed URL generation ✓
    • Feature: CDN integration ✓
    • Feature: Streaming support ✓
    • Acceptance: Audio delivery works ✓

22.7.5 Progress Endpoints#

  • 22.7.5.1 [High/XL] Implement session tracking endpoints ✓

    • Endpoint: POST /sessions ✓
    • Endpoint: PATCH /sessions/:id ✓
    • Endpoint: GET /sessions ✓
    • Endpoint: GET /sessions/:id ✓
    • Data: Start, pause, complete, duration ✓
    • Acceptance: Session tracking works ✓
  • 22.7.5.2 [High/L] Implement progress endpoints ✓

    • Endpoint: GET /progress/streak ✓
    • Endpoint: GET /progress/statistics ✓
    • Endpoint: GET /progress/history ✓
    • Query: Date range, granularity ✓
    • Acceptance: Progress endpoints work ✓
  • 22.7.5.3 [High/M] Implement course progress endpoints ✓

    • Endpoint: GET /courses/:id/progress ✓
    • Endpoint: POST /courses/:id/lessons/:lessonId/complete ✓
    • Endpoint: POST /courses/:id/start ✓
    • Acceptance: Course progress works ✓
  • 22.7.5.4 [High/M] Implement achievements endpoints ✓

    • Endpoint: GET /achievements ✓
    • Endpoint: GET /achievements/:id ✓
    • Feature: Achievement unlock logic ✓
    • Acceptance: Achievements work ✓

22.7.6 User Library Endpoints#

  • 22.7.6.1 [High/M] Implement favorites endpoints ✓

    • Endpoint: GET /favorites ✓
    • Endpoint: POST /favorites/:meditationId ✓
    • Endpoint: DELETE /favorites/:meditationId ✓
    • Endpoint: GET /favorites/:meditationId (check status) ✓
    • Acceptance: Favorites work ✓
  • 22.7.6.2 [Medium/M] Implement history endpoints ✓

    • Endpoint: GET /history ✓
    • Endpoint: DELETE /history ✓
    • Endpoint: DELETE /history/:id ✓
    • Acceptance: History works ✓
  • 22.7.6.3 [Medium/M] Implement downloads tracking endpoints ✓

    • Endpoint: GET /downloads ✓
    • Endpoint: GET /downloads/:meditationId (check status) ✓
    • Endpoint: POST /downloads/:meditationId ✓
    • Endpoint: DELETE /downloads/:meditationId ✓
    • Purpose: Track what user has downloaded ✓
    • Acceptance: Download tracking works ✓

22.7.7 Subscription & Billing Endpoints#

  • 22.7.7.1 [High/XL] Implement subscription endpoints ✓

    • Endpoint: GET /subscription ✓
    • Endpoint: POST /subscription/checkout ✓
    • Endpoint: POST /subscription/cancel ✓
    • Endpoint: POST /subscription/restore ✓
    • Endpoint: POST /subscription/portal ✓
    • Endpoint: POST /subscription/webhook (Stripe) ✓
    • Acceptance: Subscription management works ✓
  • 22.7.7.2 [High/L] Implement iOS receipt validation ✓

    • Endpoint: POST /subscription/ios/verify ✓
    • Feature: App Store receipt validation ✓
    • Feature: Subscription status sync ✓
    • Acceptance: iOS purchases validated ✓
  • 22.7.7.3 [High/L] Implement Android purchase validation ✓

    • Endpoint: POST /subscription/android/verify ✓
    • Feature: Google Play purchase validation ✓
    • Feature: Subscription status sync ✓
    • Acceptance: Android purchases validated ✓
  • 22.7.7.4 [High/M] Implement subscription webhook handlers ✓

    • Handler: Subscription created (checkout.session.completed) ✓
    • Handler: Subscription renewed (customer.subscription.updated) ✓
    • Handler: Subscription cancelled (customer.subscription.updated) ✓
    • Handler: Subscription expired (customer.subscription.deleted) ✓
    • Handler: Payment failed (invoice.payment_failed) ✓
    • Acceptance: Webhooks update subscription status ✓

22.7.8 Notification Endpoints#

  • 22.7.8.1 [High/M] Implement notification preferences endpoints ✓

    • Endpoint: GET /notifications/preferences ✓
    • Endpoint: PATCH /notifications/preferences ✓
    • Endpoint: GET /notifications/devices ✓
    • Endpoint: POST /notifications/devices ✓
    • Endpoint: DELETE /notifications/devices/:deviceId ✓
    • Settings: Daily reminder, streak, new content ✓
    • Added timezone column to userPreferences schema ✓
    • Acceptance: Notification preferences work ✓
  • 22.7.8.2 [High/M] Implement push notification service ✓

    • Service: Send to iOS (APNs) via HTTP/2 with JWT auth ✓
    • Service: Send to Android (FCM) via HTTP v1 API ✓
    • Feature: Batch sending with concurrency control ✓
    • Feature: Scheduled notifications via Redis sorted sets ✓
    • Feature: Invalid token detection and cleanup ✓
    • Acceptance: Push notifications send ✓
  • 22.7.8.3 [Medium/M] Implement reminder scheduling ✓

    • Feature: Daily meditation reminder (sendMeditationReminder) ✓
    • Feature: Streak reminder (sendStreakReminder) ✓
    • Feature: Course continuation reminder (sendCourseProgressReminder) ✓
    • Feature: Timezone-aware scheduling (calculateNextOccurrence) ✓
    • Feature: Recurring notifications (daily/weekly/monthly) ✓
    • Acceptance: Reminders scheduled correctly ✓

22.8 Content Pipeline & Asset Management#

22.8.1 Content Structure#

  • 22.8.1.1 [High/L] Define content directory structure ✓

    • Directory: apps/tara/content/meditations/{category}/{slug}/ ✓
    • Structure: metadata.json, audio.mp3, thumbnail.jpg ✓
    • Created comprehensive README.md documenting structure ✓
    • Sample meditation: stress/calm-your-mind ✓
    • Acceptance: Content structure documented ✓
  • 22.8.1.2 [High/L] Define content metadata schema ✓

    • File: apps/tara/content/schemas/meditation.schema.json ✓
    • Complete JSON Schema with all fields ✓
    • Fields: id, slug, title, description, duration, teacher ✓
    • Fields: category, tags, premium, audio, thumbnail ✓
    • Validation: JSON Schema draft 2020-12 ✓
    • Acceptance: Schema defined and documented ✓
  • 22.8.1.3 [High/M] Define course content structure ✓

    • Directory: apps/tara/content/courses/{course-slug}/ ✓
    • Schema: apps/tara/content/schemas/course.schema.json ✓
    • Files: metadata.json, thumbnail.jpg, cover.jpg ✓
    • Subdirs: lessons/{day}/ with lesson content ✓
    • Sample course: foundations-of-meditation (7 days) ✓
    • Acceptance: Course structure documented ✓
  • 22.8.1.4 [High/M] Define teacher content structure ✓

    • Directory: apps/tara/content/teachers/{teacher-slug}/ ✓
    • Schema: apps/tara/content/schemas/teacher.schema.json ✓
    • Files: metadata.json, photo.jpg, bio.md ✓
    • Sample teacher: sarah-chen ✓
    • Acceptance: Teacher structure documented ✓
  • 22.8.1.5 [Medium/M] Define sound asset structure ✓

    • Directory: apps/tara/content/sounds/ ✓
    • Subdirs: ambient/, bells/, music/ ✓
    • Schema: apps/tara/content/schemas/sound.schema.json ✓
    • Sample sound: ambient/rain-soft.json ✓
    • Acceptance: Sound structure documented ✓
  • 22.8.1.6 [Medium/M] Define collection content structure ✓

    • Directory: apps/tara/content/collections/{collection-slug}/ ✓
    • Schema: apps/tara/content/schemas/collection.schema.json ✓
    • Sample collection: stress-relief-essentials ✓
    • Acceptance: Collection structure documented ✓

22.8.2 Content Processing Pipeline#

  • 22.8.2.1 [High/XL] Create audio processing pipeline ✓

    • Script: tools/tara/process-audio.ts ✓
    • Process: Normalize audio to -16 LUFS ✓
    • Process: Convert to MP3 and M4A formats ✓
    • Process: Generate high/standard/low quality levels ✓
    • Process: Extract duration via ffprobe ✓
    • Batch processing support ✓
    • Acceptance: Audio processing automated ✓
  • 22.8.2.2 [High/L] Create image processing pipeline ✓

    • Script: tools/tara/process-images.ts ✓
    • Process: Resize to 1024/512/256/128 ✓
    • Process: Optimize with sharp ✓
    • Process: Generate all thumbnail sizes ✓
    • Process: Convert to JPEG and WebP ✓
    • Dominant color extraction ✓
    • Acceptance: Image processing automated ✓
  • 22.8.2.3 [High/L] Create content validation pipeline ✓

    • Script: tools/tara/validate-content.ts ✓
    • Validate: Required fields against schema ✓
    • Validate: UUID and slug formats ✓
    • Validate: Required files exist ✓
    • Validate: Audio duration with ffprobe ✓
    • JSON output for CI ✓
    • Acceptance: Content validation automated ✓
  • 22.8.2.4 [High/M] Create content upload pipeline ✓

    • Script: tools/tara/upload-content.ts ✓
    • Upload: To S3 with proper content types ✓
    • Generate: Signed URLs for premium content ✓
    • Cache control headers by file type ✓
    • Version prefix support ✓
    • Dry-run mode ✓
    • Acceptance: Content upload automated ✓
  • 22.8.2.5 [Medium/M] Create content versioning system ✓

    • Feature: Track content versions ✓
    • Feature: Rollback capability ✓
    • Feature: A/B testing support ✓
    • Acceptance: Content versioning works ✓

22.8.3 CDN & Asset Delivery ✅#

  • 22.8.3.1 [High/L] Configure S3 bucket for Tara content ✓

    • Bucket: tara-content-{env} ✓
    • Config: CORS for web playback ✓
    • Config: Lifecycle rules ✓
    • Config: Access logging ✓
    • Acceptance: S3 bucket configured ✓
  • 22.8.3.2 [High/M] Configure CloudFront CDN ✓

    • Distribution: Tara content delivery ✓
    • Config: Edge caching ✓
    • Config: Signed URLs for premium content ✓
    • Config: HTTPS only ✓
    • Acceptance: CDN configured ✓
  • 22.8.3.3 [High/M] Implement signed URL generation ✓

    • Service: Generate time-limited signed URLs ✓
    • Feature: Premium content protection ✓
    • Feature: Download URL generation ✓
    • Acceptance: Signed URLs work ✓
  • 22.8.3.4 [Medium/M] Implement content preloading strategy ✓

    • Feature: Preload next meditation in sequence ✓
    • Feature: Preload daily content ✓
    • Feature: Background preloading on Wi-Fi ✓
    • Acceptance: Preloading improves experience ✓

22.9 Analytics & Monitoring#

22.9.1 Analytics Integration#

  • 22.9.1.1 [High/L] Create analytics library ✅

    • File: libs/tara/analytics/src/index.ts
    • Export: TaraTracker class with batching, sampling, context enrichment
    • Providers: Internal (server-side), Console (dev), Memory (testing)
    • Events: Structured event tracking with type-safe API
    • Acceptance: Analytics library complete
  • 22.9.1.2 [High/XL] Define analytics events ✅

    • File: libs/tara/analytics/src/types/events.ts
    • Events: meditation_started, meditation_completed, meditation_paused, meditation_resumed, meditation_skipped
    • Events: course_started, course_completed, lesson_completed, course_progress
    • Events: timer_started, timer_completed, timer_extended
    • Events: breathing_started, breathing_completed
    • Events: subscription_started, subscription_renewed, subscription_cancelled, subscription_trial_started, subscription_trial_ended
    • Events: content_downloaded, content_deleted, content_favorited, content_unfavorited, content_rated, content_shared
    • Events: search_performed, search_result_clicked
    • Events: notification_received, notification_opened, notification_dismissed
    • Events: streak_milestone, achievement_unlocked
    • Events: onboarding_started, onboarding_step_completed, onboarding_completed, onboarding_skipped
    • Events: app_opened, app_backgrounded, app_crashed
    • Events: screen_viewed, error_occurred
    • Properties: Full type definitions with required/optional fields
    • Builders: Type-safe event builder functions in src/events/index.ts
    • Acceptance: All events defined with types and builders
  • 22.9.1.3 [High/M] Integrate analytics provider ✅

    • API: POST /api/v1/analytics/events - Batch event tracking endpoint
    • API: POST /api/v1/analytics/experiments/assignment - Get experiment variant
    • API: POST /api/v1/analytics/flags/evaluate - Evaluate feature flag
    • API: POST /api/v1/analytics/user/experiments - Get all user experiments/flags
    • Database: analytics_events table for event storage
    • Database: experiments table for experiment definitions
    • Database: experiment_assignments table for user assignments
    • Database: feature_flags table for feature flag definitions
    • Server-side tracking with batched event ingestion
    • Acceptance: Analytics provider integrated
  • 22.9.1.4 [High/M] Create analytics dashboards ✅

    • API: GET /api/v1/analytics/dashboard/summary - Dashboard summary with all metrics
    • API: GET /api/v1/analytics/dashboard/trends - Time-series trend data
    • API: GET /api/v1/analytics/dashboard/realtime - Real-time metrics
    • API: GET /api/v1/analytics/dashboard/funnel - Funnel analysis
    • Service: DashboardService with aggregation queries
    • Metrics: User activity (DAU/WAU/MAU, new users, returning users)
    • Metrics: Session metrics (total, duration, platform/device breakdown)
    • Metrics: Content engagement (plays, completions, top content)
    • Metrics: Subscription metrics (subscribers, trials, churn, revenue)
    • Metrics: Retention metrics (day 1-90)
    • Metrics: Funnel analysis (onboarding, custom funnels)
    • Acceptance: Dashboards provide insights
  • 22.9.1.5 [Medium/M] Implement A/B testing framework ✅

    • File: libs/tara/analytics/src/experiments/experiment-manager.ts
    • Feature: Experiment definition with variants and weights
    • Feature: Deterministic user bucketing with murmurhash3
    • Feature: Feature flags with rule-based evaluation
    • Feature: Audience targeting (subscription tier, platform, app version, country, language, custom segments)
    • Feature: User overrides for testing
    • Feature: In-memory store for development/testing
    • Acceptance: A/B testing framework complete

22.9.2 Error Tracking & Monitoring#

  • 22.9.2.1 [High/M] Integrate error tracking ✅

    • Library: @tara/monitoring with Sentry-compatible API
    • File: libs/tara/monitoring/src/error-tracking/error-tracker.ts
    • Features: Breadcrumbs, user context, scopes, tags, extras
    • Providers: Console (dev), Memory (testing), Server (production)
    • Types: Tara-specific breadcrumb categories (meditation, subscription, audio)
    • API: Error tracking middleware for Tara API
    • Acceptance: Errors tracked and reported
  • 22.9.2.2 [High/M] Set up application monitoring

    • Tool: DataDog, New Relic, or similar
    • Metrics: API response times
    • Metrics: Error rates
    • Metrics: Database query performance
    • Alerts: Threshold-based alerting
    • Acceptance: Monitoring in place
  • 22.9.2.3 [High/M] Set up uptime monitoring

    • Tool: Pingdom, UptimeRobot, or similar
    • Monitors: API health endpoint
    • Monitors: Web app availability
    • Alerts: Downtime notifications
    • Acceptance: Uptime monitored
  • 22.9.2.4 [Medium/M] Create health check endpoints ✅

    • Endpoint: GET /health - Full health status with all checks
    • Endpoint: GET /ready - Readiness check for load balancer
    • Checks: Database, Redis health with latency metrics
    • Status: Returns healthy/degraded/unhealthy
    • Acceptance: Health checks work

22.10 Testing & Quality Assurance#

22.10.1 Unit Testing#

  • 22.10.1.1 [High/L] Create meditation core unit tests

    • File: libs/meditation/*/src/**/*.test.ts
    • Tests: Player functionality
    • Tests: Timer functionality
    • Tests: Breathing patterns
    • Tests: Progress calculations
    • Coverage: 80%+ coverage target
    • Acceptance: Core library tests pass
  • 22.10.1.2 [High/L] Create Tara UI component tests

    • File: libs/tara/ui/src/**/*.test.tsx
    • Tests: All components render
    • Tests: Props work correctly
    • Tests: Interactions work
    • Tool: React Testing Library
    • Acceptance: UI tests pass
  • 22.10.1.3 [High/M] Create Tara content library tests

    • File: libs/tara/content/src/**/*.test.ts
    • Tests: API client methods
    • Tests: Caching logic
    • Tests: Search functionality
    • Acceptance: Content tests pass
  • 22.10.1.4 [High/L] Create API unit tests

    • File: apps/tara/api/src/**/*.test.ts
    • Tests: Controller logic
    • Tests: Service logic
    • Tests: Middleware
    • Acceptance: API tests pass

22.10.2 Integration Testing#

  • 22.10.2.1 [High/L] Create API integration tests

    • File: apps/tara/api/test/integration/
    • Tests: Authentication flow
    • Tests: Content endpoints
    • Tests: Progress tracking
    • Tests: Subscription flow
    • Setup: Test database
    • Acceptance: Integration tests pass
  • 22.10.2.2 [High/M] Create database integration tests

    • File: apps/tara/api/test/integration/
    • File: libs/tara/database/prisma/schema.prisma
    • Tests: Migrations run
    • Tests: Queries work
    • Tests: Data integrity
    • Acceptance: Database tests pass
  • 22.10.2.3 [Medium/M] Create external service integration tests

    • Tests: Payment provider (test mode)
    • Tests: Push notification service
    • Tests: CDN access
    • Acceptance: External integrations work

22.10.3 End-to-End Testing#

  • 22.10.3.1 [High/XL] Create web E2E tests ✅ COMPLETED

    • File: apps/tara/web/e2e/
    • Tool: Playwright
    • Tests: Authentication flow
    • Tests: Browse and play meditation
    • Tests: Timer and breathing
    • Tests: Progress tracking
    • Tests: Subscription flow
    • Acceptance: Web E2E tests pass
    • COMPLETED: Comprehensive Playwright E2E suite with 194 test cases
      • Page Object Models: auth, meditation, timer, progress, subscription
      • Multi-browser support (Chrome, Firefox, Safari)
      • Mobile viewport testing
      • Authentication state persistence
    • VERIFIED (2026-02-10):
      • pnpm nx run @tara/web:e2e -- --project=chromium => 194 passed
      • pnpm nx run-many -t lint,typecheck --projects=@tara/web,@tara/api --skip-nx-cache --parallel=2 => passed (warnings only)
      • Phase 22 concrete filesystem references audited: 133/133 exist
  • 22.10.3.2 [High/XL] Create mobile E2E tests ✅ COMPLETED

    • File: apps/tara/mobile/e2e/
    • Tool: Maestro
    • Tests: Authentication flow
    • Tests: Browse and play meditation
    • Tests: Offline mode
    • Tests: Push notifications
    • Acceptance: Mobile E2E tests pass
    • COMPLETED: Comprehensive Maestro E2E suite with 23 YAML flows total (19 feature flows + 4 common/smoke/regression orchestration flows)
      • Auth: login, signup, logout
      • Meditation: browse, play, favorite
      • Offline: download, play offline, manage downloads
      • Notifications: permission, settings, reminder
      • Timer, progress, settings, onboarding flows
  • 22.10.3.3 [High/M] Create API E2E tests

    • File: apps/tara/api/test/integration/
    • Tests: Full user journey
    • Tests: Subscription lifecycle
    • Tests: Content delivery
    • Acceptance: API E2E tests pass

22.10.4 App Store Compliance Testing#

  • 22.10.4.1 [High/L] Create content compliance checklist

    • Check: No adult content
    • Check: No violence
    • Check: No hate speech
    • Check: Proper content ratings
    • Check: Privacy policy compliance
    • Acceptance: Content compliant with guidelines
  • 22.10.4.2 [High/M] Perform iOS App Store review checklist

    • Check: App review guidelines compliance
    • Check: In-app purchase implementation
    • Check: Privacy labels accurate
    • Check: Sign in with Apple (if social login)
    • Check: App Tracking Transparency
    • Acceptance: Ready for iOS review
  • 22.10.4.3 [High/M] Perform Google Play review checklist

    • Check: Play Store policies compliance
    • Check: Billing implementation
    • Check: Data safety section
    • Check: Target API level
    • Check: 64-bit support
    • Acceptance: Ready for Play Store review
  • 22.10.4.4 [High/M] Create accessibility compliance tests

    • Tests: Screen reader support
    • Tests: Color contrast
    • Tests: Touch target sizes
    • Tests: Text scaling
    • Standard: WCAG 2.1 AA
    • Acceptance: Accessibility compliant

22.10.5 Performance Testing#

  • 22.10.5.1 [High/M] Create web performance tests

    • Metrics: First Contentful Paint
    • Metrics: Largest Contentful Paint
    • Metrics: Cumulative Layout Shift
    • Metrics: Time to Interactive
    • Tool: Lighthouse CI
    • Acceptance: Performance meets targets
  • 22.10.5.2 [High/M] Create mobile performance tests

    • Metrics: App startup time
    • Metrics: Memory usage
    • Metrics: Battery impact
    • Metrics: Network usage
    • Acceptance: Performance acceptable
  • 22.10.5.3 [High/M] Create API load tests

    • Tool: k6, Artillery, or similar
    • Tests: Concurrent users
    • Tests: Requests per second
    • Tests: Response times under load
    • Acceptance: API handles expected load

22.11 CI/CD & Deployment#

22.11.1 CI Pipeline#

  • 22.11.1.1 [High/L] Create CI workflow for Tara

    • File: .github/workflows/tara-ci.yml
    • Jobs: Lint, type-check, test
    • Jobs: Build web, build mobile
    • Trigger: PR to main, push to main
    • Acceptance: CI runs on every change
  • 22.11.1.2 [High/M] Configure test coverage reporting

    • Tool: Codecov or similar
    • Config: Coverage thresholds
    • Config: PR comments with coverage
    • Acceptance: Coverage tracked
  • 22.11.1.3 [High/M] Configure build caching

    • Cache: Node modules
    • Cache: Nx computation cache
    • Cache: Build artifacts
    • Acceptance: Builds are fast

22.11.2 Web Deployment#

  • 22.11.2.1 [High/L] Create web deployment pipeline

    • File: .github/workflows/tara-web-deploy.yml
    • Environments: Staging, production
    • Platform: Vercel, AWS, or similar
    • Trigger: Manual or auto on main
    • Acceptance: Web deploys successfully
  • 22.11.2.2 [High/M] Configure web environment variables

    • Secrets: API keys, endpoints
    • Config: Per-environment settings
    • Management: GitHub secrets or similar
    • Acceptance: Secrets managed securely
  • 22.11.2.3 [Medium/M] Configure web preview deployments

    • Feature: Deploy preview for PRs
    • Feature: Unique URL per PR
    • Feature: Auto cleanup
    • Acceptance: Preview deployments work

22.11.3 API Deployment#

  • 22.11.3.1 [High/L] Create API deployment pipeline

    • File: .github/workflows/tara-api-deploy.yml
    • Build: Docker image
    • Deploy: ECS, Kubernetes, or similar
    • Environments: Staging, production
    • Acceptance: API deploys successfully
  • 22.11.3.2 [High/M] Create API Docker configuration

    • File: apps/tara/api/Dockerfile
    • Base: Node.js Alpine
    • Config: Multi-stage build
    • Config: Security hardening
    • Acceptance: Docker image builds
  • 22.11.3.3 [High/M] Configure API infrastructure

    • Resources: Compute (ECS tasks, pods)
    • Resources: Database (RDS, managed Postgres)
    • Resources: Redis (ElastiCache, managed Redis)
    • Resources: Load balancer
    • Acceptance: Infrastructure provisioned
  • 22.11.3.4 [High/M] Configure API secrets management

    • Tool: AWS Secrets Manager, Vault, or similar
    • Secrets: Database credentials
    • Secrets: API keys, JWT secrets
    • Acceptance: Secrets managed securely
  • 22.11.3.5 [Medium/M] Configure database migrations in CI/CD

    • Step: Run migrations before deploy
    • Feature: Rollback on failure
    • Feature: Migration status check
    • Acceptance: Migrations automated

22.11.4 Mobile Deployment#

  • 22.11.4.1 [High/XL] Create iOS deployment pipeline

    • File: .github/workflows/tara-ios-deploy.yml
    • Build: Expo EAS or Fastlane
    • Sign: Code signing with certificates
    • Deploy: TestFlight (staging), App Store (production)
    • Acceptance: iOS builds and deploys
  • 22.11.4.2 [High/XL] Create Android deployment pipeline

    • File: .github/workflows/tara-android-deploy.yml
    • Build: Expo EAS or Fastlane
    • Sign: Keystore signing
    • Deploy: Internal testing (staging), Play Store (production)
    • Acceptance: Android builds and deploys
  • 22.11.4.3 [High/L] Configure mobile code signing

    • iOS: Certificates, provisioning profiles
    • Android: Upload key, app signing key
    • Storage: GitHub secrets or similar
    • Acceptance: Code signing works
  • 22.11.4.4 [High/M] Configure mobile build versioning

    • Feature: Auto-increment build numbers
    • Feature: Version from package.json
    • Feature: Build metadata
    • Acceptance: Versioning automated
  • 22.11.4.5 [Medium/M] Configure mobile beta distribution

    • iOS: TestFlight
    • Android: Firebase App Distribution or Play Internal
    • Feature: Tester groups
    • Acceptance: Beta distribution works

22.12 Documentation#

22.12.1 Technical Documentation#

  • 22.12.1.1 [High/L] Create Tara architecture documentation

    • File: docs/domains/tara/architecture.md
    • Content: System overview
    • Content: Component relationships
    • Content: Data flow diagrams
    • Acceptance: Architecture documented
  • 22.12.1.2 [High/M] Create API documentation

    • File: docs/domains/tara/api/
    • Content: Endpoint reference
    • Content: Authentication guide
    • Content: Error handling
    • Content: Rate limiting
    • Acceptance: API documented
  • 22.12.1.3 [High/M] Create development setup guide

    • File: docs/domains/tara/development/README.md
    • Content: Prerequisites
    • Content: Local setup steps
    • Content: Running apps locally
    • Content: Common issues
    • Acceptance: Setup guide complete
  • 22.12.1.4 [High/M] Create deployment documentation

    • File: docs/domains/tara/development/deployment.md
    • Content: Deployment process
    • Content: Environment configuration
    • Content: Rollback procedures
    • Acceptance: Deployment documented
  • 22.12.1.5 [Medium/M] Create content management guide

    • File: docs/domains/tara/development/content.md
    • Content: Content structure
    • Content: Adding new content
    • Content: Content processing
    • Acceptance: Content guide complete

22.12.2 User Documentation#

  • 22.12.2.1 [Medium/M] Create help center content

    • Content: Getting started guide
    • Content: FAQ
    • Content: Troubleshooting
    • Content: Contact support
    • Acceptance: Help content ready
  • 22.12.2.2 [High/M] Create privacy policy

    • File: apps/tara/docs/legal/privacy-policy.md
    • Content: Data collection
    • Content: Data usage
    • Content: User rights
    • Compliance: GDPR, CCPA
    • Acceptance: Privacy policy complete
  • 22.12.2.3 [High/M] Create terms of service

    • File: apps/tara/docs/legal/terms-of-service.md
    • Content: Usage terms
    • Content: Subscription terms
    • Content: Content guidelines
    • Acceptance: Terms of service complete
  • 22.12.2.4 [Medium/M] Create App Store descriptions

    • Content: Short description
    • Content: Full description
    • Content: Keywords
    • Content: What's new (release notes template)
    • Acceptance: Store descriptions ready

22.13 Launch Preparation#

Verification note (2026-02-10): items in 22.13.2 and live-operations items in 22.13.3 require external console/runbook evidence (App Store Connect, Google Play Console, production monitoring/incident systems) and cannot be fully proven from repository source alone.

22.13.1 Pre-Launch Checklist#

  • 22.13.1.1 [High/L] Create launch checklist

    • File: docs/domains/tara/launch/launch-checklist.md
    • Checks: All features implemented
    • Checks: All tests passing
    • Checks: Performance acceptable
    • Checks: Security review complete
    • Checks: Legal review complete
    • Acceptance: Checklist comprehensive
  • 22.13.1.2 [High/M] Perform security audit

    • Audit: Authentication/authorization
    • Audit: Data protection
    • Audit: API security
    • Audit: Mobile app security
    • Audit: Third-party dependencies
    • Acceptance: Security issues addressed
  • 22.13.1.3 [High/M] Perform accessibility audit

    • Audit: Screen reader testing
    • Audit: Keyboard navigation
    • Audit: Color contrast
    • Audit: Touch targets
    • Acceptance: Accessibility issues addressed
  • 22.13.1.4 [High/M] Perform load testing

    • Test: Expected user load
    • Test: Peak load scenarios
    • Test: Sustained load
    • Fix: Performance bottlenecks
    • Acceptance: System handles load
  • 22.13.1.5 [Medium/M] Create rollback plan

    • File: docs/domains/tara/launch/rollback-plan.md
    • Plan: API rollback procedure
    • Plan: Mobile rollback (store review)
    • Plan: Database rollback
    • Plan: Communication plan
    • Acceptance: Rollback plan documented

22.13.2 App Store Submission#

  • 22.13.2.1 [High/L] Prepare iOS App Store submission

    • Submit: App binary
    • Submit: App Store assets
    • Submit: App information
    • Submit: Privacy details
    • Submit: Review notes
    • Acceptance: Submitted to App Store
  • 22.13.2.2 [High/L] Prepare Google Play submission

    • Submit: App bundle
    • Submit: Store listing
    • Submit: Content rating
    • Submit: Data safety
    • Submit: Release notes
    • Acceptance: Submitted to Play Store
  • 22.13.2.3 [High/M] Handle App Store review feedback

    • Process: Address rejection reasons
    • Process: Resubmit with fixes
    • Process: Appeal if necessary
    • Acceptance: Apps approved

22.13.3 Launch Monitoring#

  • 22.13.3.1 [High/M] Set up launch monitoring dashboard

    • File: docs/domains/tara/launch/monitoring.md
    • Metrics: Active users
    • Metrics: Error rates
    • Metrics: API performance
    • Metrics: App crashes
    • Metrics: User feedback
    • Acceptance: Dashboard ready
  • 22.13.3.2 [High/M] Create incident response plan

    • File: docs/domains/tara/launch/incident-response.md
    • Process: Severity levels
    • Process: Escalation paths
    • Process: Communication templates
    • Process: On-call rotation
    • Acceptance: Incident plan ready
  • 22.13.3.3 [Medium/M] Set up user feedback channels

    • File: docs/domains/tara/launch/feedback-channels.md
    • Channel: In-app feedback
    • Channel: App store reviews
    • Channel: Support email
    • Channel: Social media monitoring
    • Acceptance: Feedback channels active

Phase 22 Summary Statistics#

Section Task Count
22.1 Foundation & Infrastructure Setup 20
22.2 Shared Meditation Core Library 49
22.3 Tara UI Component Library 40
22.4 Tara Content Management 13
22.5 Tara Web Application 28
22.6 Tara Mobile Application 37
22.7 Tara Backend API 32
22.8 Content Pipeline & Asset Management 15
22.9 Analytics & Monitoring 9
22.10 Testing & Quality Assurance 17
22.11 CI/CD & Deployment 16
22.12 Documentation 9
22.13 Launch Preparation 11
TOTAL Phase 22 296

Updated Grand Total#

Phase Task Count
Phase 0-14 (Original) 796
Phase 15: Physical Wellness & Fitness 503
Phase 16: Video-to-Animation Pipeline 346
Phase 17: State-of-the-Art AI Integration 424
Phase 18: Production Readiness Remediation 847
Phase 19: AWS ECS + RunPod Infrastructure 126
Phase 20: Eve/Aphrodite Platform 145
Phase 21: Nyx Cosmic Observatory 251
Phase 22: Tara Meditation Platform 296
GRAND TOTAL 3,734