Eve library

Tara Content Directory

Other

Revision 1

On this page

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