This directory contains all meditation content for the Tara app.
Directory Structure#
text
content/
├── meditations/ # Meditation audio content
│ └── {category}/ # Category folders (sleep, stress, focus, etc.)
│ └── {slug}/ # Individual meditation
│ ├── metadata.json
│ ├── audio.mp3
│ ├── thumbnail.jpg
│ ├── transcript.md
│ └── captions.vtt
│
├── courses/ # Multi-day meditation programs
│ └── {course-slug}/
│ ├── metadata.json
│ ├── thumbnail.jpg
│ └── lessons/
│ └── {day-number}/
│ ├── metadata.json
│ ├── audio.mp3
│ ├── thumbnail.jpg
│ ├── transcript.md
│ └── captions.vtt
│
├── teachers/ # Teacher/instructor profiles
│ └── {teacher-slug}/
│ ├── metadata.json
│ ├── photo.jpg
│ └── bio.md
│
├── sounds/ # Background sounds and music
│ ├── ambient/ # Nature sounds, white noise
│ ├── bells/ # Meditation bells and chimes
│ └── music/ # Background music tracks
│
├── collections/ # Curated content collections
│ └── {collection-slug}/
│ └── metadata.json
│
└── schemas/ # JSON Schema definitions
├── meditation.schema.json
├── course.schema.json
├── teacher.schema.json
└── collection.schema.json
Categories#
Available meditation categories:
| Category | Slug | Description |
|---|---|---|
| Sleep | sleep |
Guided sleep meditations |
| Stress Relief | stress |
Stress and anxiety relief |
| Focus | focus |
Concentration and productivity |
| Anxiety | anxiety |
Anxiety management techniques |
| Morning | morning |
Start-your-day routines |
| Evening | evening |
Wind-down practices |
| Breathwork | breathwork |
Breathing exercises |
| Body Scan | body_scan |
Body awareness practices |
| Visualization | visualization |
Guided imagery |
| Gratitude | gratitude |
Gratitude and appreciation |
| Self Compassion | self_compassion |
Self-love and acceptance |
| Relationships | relationships |
Loving-kindness and connection |
| Work | work |
Workplace mindfulness |
| Creativity | creativity |
Creative flow and inspiration |
| General | general |
General mindfulness practices |
Content Types#
| Type | Description |
|---|---|
guided |
Instructor-led meditation |
unguided |
Timer-only with optional background |
music |
Music-based meditation |
soundscape |
Nature sounds and ambient audio |
story |
Narrative sleep stories |
Experience Levels#
| Level | Target Audience |
|---|---|
beginner |
New to meditation (< 1 month) |
intermediate |
Regular practice (1-6 months) |
advanced |
Experienced practitioners (6+ months) |
Audio Requirements#
Guided audio must include a full markdown transcript and at least one sidecar
caption track. The English launch track uses WebVTT (captions.vtt) with
non-overlapping cues that cover the full session duration.
Quality Levels#
| Quality | Bitrate | Sample Rate | Use Case |
|---|---|---|---|
| high | 256kbps | 44.1kHz | WiFi streaming |
| standard | 128kbps | 44.1kHz | Default streaming |
| low | 64kbps | 22.05kHz | Cellular/offline |
Format Requirements#
- Primary: MP3 (most compatible)
- Alternative: M4A/AAC (better quality at lower bitrates)
- Metadata: ID3 tags must be embedded
Audio Specifications#
- Mono or stereo (instructor voice should be centered)
- Normalized to -16 LUFS (loudness standard)
- No clipping or distortion
- Fade in/out at start/end
- Silence removed from beginning (< 0.5s allowed)
Image Requirements#
Thumbnails#
| Size | Resolution | Use Case |
|---|---|---|
| large | 1024x1024 | Full detail view |
| medium | 512x512 | Card displays |
| small | 256x256 | List views |
| thumbnail | 128x128 | Small thumbnails |
Format Requirements#
- Format: JPEG (photos) or PNG (graphics)
- Color Space: sRGB
- Quality: 80-90% JPEG quality
- Aspect Ratio: 1:1 (square) for thumbnails
Naming Conventions#
File Names#
- Use lowercase with hyphens:
calm-your-mind - No spaces or special characters
- Keep names descriptive but concise
- Examples:
morning-energy-boostdeep-sleep-relaxation5-minute-breathing
IDs#
- UUIDs for database records
- Slugs for URL paths
- Format:
{category}/{slug}
Validation#
All content must pass validation before publishing:
bash
# Validate all content
pnpm nx run tara-content:validate
# Validate specific content
pnpm nx run tara-content:validate --path=meditations/stress/calm-your-mind
Processing Pipeline#
Content is processed through the following stages:
- Validation - Schema and file validation
- Audio Processing - Normalization, format conversion
- Image Processing - Resize, optimization
- Upload - S3/CDN deployment
- Database Sync - Update content catalog
bash
# Process new content
pnpm nx run tara-content:process --path=meditations/stress/calm-your-mind
# Process all pending content
pnpm nx run tara-content:process --all