# Tara Content Directory

This directory contains all meditation content for the Tara app.

## Directory Structure

```
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-boost`
  - `deep-sleep-relaxation`
  - `5-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:

1. **Validation** - Schema and file validation
2. **Audio Processing** - Normalization, format conversion
3. **Image Processing** - Resize, optimization
4. **Upload** - S3/CDN deployment
5. **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
```
