Overview#
This document provides comprehensive guidelines for creating structured learning experiences on the Lilith platform. Courses are progressive learning journeys that combine meditation sessions, teachings, exercises, and contemplations to guide users through systematic skill development.
Table of Contents#
- Course Types
- Course Design Principles
- Lesson Types
- Course Structure Templates
- Progression Design
- Content Components
- Data Structure Requirements
- Quality Checklist
Course Types#
The platform supports four course types:
| Type | Description | Typical Use Case |
|---|---|---|
course |
Structured learning with sequential lessons | "7-Day Meditation Basics" |
series |
Related content without strict order | "Stress Relief Collection" |
collection |
Curated content bundles | "Best of Zen Meditations" |
path |
Multi-course learning journey | "Journey to Mindfulness Mastery" |
Course vs. Series#
| Aspect | Course | Series |
|---|---|---|
| Order | Sequential (Day 1, Day 2...) | Flexible |
| Prerequisites | Yes | No |
| Progress Tracking | Lesson-by-lesson | Content-by-content |
| Completion | All lessons required | Optional |
| Duration | Fixed (7/14/21/30 days) | Open-ended |
Course Design Principles#
1. Progressive Skill Building#
Courses must follow a progressive structure that builds skills incrementally:
Foundation → Core Skills → Integration → Application
Example: 7-Day Beginner Course
- Days 1-2: Foundation (breath awareness, posture)
- Days 3-4: Core Skills (concentration, body awareness)
- Days 5-6: Integration (combining techniques)
- Day 7: Application (daily life integration)
2. Daily Practice Commitment#
| Duration Type | Daily Time | Total Course Days | Best For |
|---|---|---|---|
| Quick Start | 5-10 min | 5-7 days | Beginners, time-constrained |
| Standard | 10-15 min | 7-14 days | General audience |
| Deep Dive | 15-30 min | 14-30 days | Committed practitioners |
| Intensive | 30-60 min | 21-60 days | Advanced, retreat-style |
3. Consistent Rhythm#
Each lesson should follow a predictable rhythm:
- Opening (1-2 min) - Welcome, context, intention
- Teaching (2-5 min) - New concept or technique
- Practice (5-20 min) - Guided meditation/exercise
- Integration (1-2 min) - Takeaways for the day
4. Manageable Cognitive Load#
- One new concept per lesson maximum
- Review previous concepts before introducing new ones
- Provide written summaries for complex teachings
- Allow rest days in longer courses (14+ days)
Lesson Types#
Each lesson has a primary type determining its content format:
| Type | Description | Duration | When to Use |
|---|---|---|---|
meditation |
Guided meditation practice | 5-30 min | Core practice sessions |
audio |
Audio teaching without meditation | 3-10 min | Concept introductions |
video |
Video teaching | 3-15 min | Visual demonstrations |
text |
Written content | 3-5 min read | Detailed explanations |
quiz |
Knowledge check | 2-5 min | Mid-course/end review |
exercise |
Active practice assignment | Varies | Journaling, observation |
interactive |
Interactive content | 5-15 min | Technique selection |
Lesson Type Distribution#
Recommended distribution for a 7-day course:
| Day | Primary Lesson | Secondary Content |
|---|---|---|
| 1 | Video (intro) | Meditation |
| 2 | Meditation | Text (recap) |
| 3 | Meditation | Audio (teaching) |
| 4 | Meditation | Exercise (journal) |
| 5 | Meditation | Text (deepening) |
| 6 | Meditation | Quiz (review) |
| 7 | Meditation | Video (integration) |
Course Structure Templates#
7-Day Beginner Course#
Target: New to meditation Daily Time: 10-15 minutes Focus: Single skill (e.g., breath awareness, stress relief)
Day 1: Welcome & First Practice
├── Lesson 1.1: Course Introduction (video, 3 min)
├── Lesson 1.2: What is Meditation? (text, 2 min read)
└── Lesson 1.3: Your First Meditation (meditation, 5 min)
Day 2: Building Foundation
├── Lesson 2.1: Finding Your Posture (text/video, 3 min)
└── Lesson 2.2: Breath Awareness Basics (meditation, 8 min)
Day 3: Deepening Practice
├── Lesson 3.1: Working with Distractions (audio, 3 min)
└── Lesson 3.2: Guided Practice (meditation, 10 min)
Day 4: Common Challenges
├── Lesson 4.1: When Your Mind Wanders (text, 2 min)
├── Lesson 4.2: Guided Practice (meditation, 10 min)
└── Lesson 4.3: Reflection Exercise (exercise, 5 min)
Day 5: Expanding Awareness
├── Lesson 5.1: Body Awareness Introduction (audio, 3 min)
└── Lesson 5.2: Body-Breath Connection (meditation, 12 min)
Day 6: Integration
├── Lesson 6.1: Making It a Habit (text, 3 min)
├── Lesson 6.2: Full Practice (meditation, 12 min)
└── Lesson 6.3: Knowledge Check (quiz, 3 min)
Day 7: Moving Forward
├── Lesson 7.1: Your Meditation Journey (video, 4 min)
├── Lesson 7.2: Final Practice (meditation, 15 min)
└── Lesson 7.3: Completion & Next Steps (text, 2 min)
14-Day Intermediate Course#
Target: Some meditation experience Daily Time: 15-20 minutes Focus: Multiple skills or tradition introduction
Week 1: Foundations Review & New Skills
├── Day 1: Welcome & Assessment
│ ├── Course Overview (video)
│ ├── Self-Assessment (interactive)
│ └── Baseline Practice (meditation, 10 min)
├── Day 2: Core Technique Refinement
├── Day 3: Introducing New Element
├── Day 4: Practice & Integration
├── Day 5: Deepening Understanding
├── Day 6: Challenges & Solutions
└── Day 7: Week 1 Review (rest/light practice)
Week 2: Application & Mastery
├── Day 8: Advanced Techniques
├── Day 9: Situational Practice
├── Day 10: Emotional Applications
├── Day 11: Extended Practice
├── Day 12: Daily Life Integration
├── Day 13: Comprehensive Review
└── Day 14: Graduation & Path Forward
21-Day Deep Dive Course#
Target: Committed practitioners Daily Time: 20-30 minutes Focus: Tradition-specific or thematic deep dive
Week 1: Foundation (Days 1-7)
├── History & Context (2 days)
├── Core Practices (3 days)
├── Initial Challenges (1 day)
└── Week Review (1 day)
Week 2: Development (Days 8-14)
├── Advanced Techniques (3 days)
├── Integration Practices (2 days)
├── Obstacle Navigation (1 day)
└── Week Review (1 day)
Week 3: Mastery (Days 15-21)
├── Extended Practices (2 days)
├── Life Application (2 days)
├── Teaching Others (1 day)
├── Comprehensive Review (1 day)
└── Graduation & Continuation (1 day)
Progression Design#
Difficulty Levels#
| Level | Prerequisites | Techniques | Guidance |
|---|---|---|---|
beginner |
None | Basic (breath, body scan) | High (constant) |
intermediate |
1+ beginner course | Moderate (visualization, mantra) | Medium (periodic) |
advanced |
2+ intermediate courses | Complex (self-inquiry, silence) | Low (minimal) |
all_levels |
None | Adaptable | Variable |
Skill Progression Map#
BEGINNER SKILLS
├── Breath awareness
├── Basic body scan
├── Posture fundamentals
└── Distraction management
↓
INTERMEDIATE SKILLS
├── Extended concentration
├── Visualization basics
├── Emotional awareness
├── Mantra introduction
└── Walking meditation
↓
ADVANCED SKILLS
├── Self-inquiry practices
├── Non-dual awareness
├── Extended silence
├── Teaching fundamentals
└── Retreat preparation
Prerequisites System#
Lessons can require prerequisites that users must complete first:
// Example: Advanced lesson requiring two prerequisites
{
lessonId: "zen-shikantaza-01",
prerequisites: [
{ lessonId: "zen-zazen-intro", isRequired: true },
{ lessonId: "concentration-basics", isRequired: true }
]
}
Prerequisites Rules:
- Maximum 3 prerequisites per lesson
- Prerequisites must be from the same course or earlier courses in a path
- Circular dependencies are automatically detected and rejected
Content Components#
Teaching Component#
Every course should include educational content explaining the "why" behind practices.
| Teaching Type | Format | Duration | Placement |
|---|---|---|---|
| Concept Introduction | Video/Audio | 2-5 min | Lesson start |
| Technique Explanation | Text/Video | 2-3 min | Before practice |
| FAQ/Common Questions | Text | 2 min read | Mid-course |
| Deep Dive | Text/Audio | 5-10 min | Optional supplemental |
Practice Component#
The meditation or exercise that forms the core experience.
Practice Guidelines:
- Always include timer visible during practice
- Provide bell/chime at transitions
- Include optional background audio
- Support offline download
Reflection Component#
Exercises that help integrate learning.
| Reflection Type | Description | When |
|---|---|---|
| Journaling Prompt | Written reflection questions | After practice |
| Observation Exercise | Daily life awareness task | Morning/evening |
| Progress Check-in | Self-assessment | Weekly |
| Quote Contemplation | Reflect on wisdom quote | Lesson opener |
Quiz Component#
Knowledge checks to reinforce learning.
Quiz Types:
multiple_choice- Select correct answer(s)true_false- Agree/disagree statementsshort_answer- Brief written responsematching- Connect related concepts
Quiz Guidelines:
- Maximum 5 questions per quiz
- Provide explanations for all answers
- No penalty for incorrect answers
- Use as learning tool, not assessment
Data Structure Requirements#
Course Metadata#
required:
- id: UUID (auto-generated)
- slug: URL-safe identifier (e.g., "meditation-basics-7-day")
- title: Course title (max 80 chars)
- type: course | series | collection | path
- difficulty: beginner | intermediate | advanced | all_levels
- estimatedDurationMinutes: Total course time
- status: draft | review | published | archived
recommended:
- description: 150-400 char summary
- shortDescription: 80-150 char tagline
- thumbnailUrl: 1200x630px cover image
- previewVideoUrl: 30-90 second trailer
- instructorId: Teacher profile reference
- categoryId: Primary category
- tags: Array of relevant tags (3-7)
- isPremium: Boolean for paywall
- defaultLocale: Primary language
Lesson Metadata#
required:
- id: UUID (auto-generated)
- courseId: Parent course reference
- slug: URL-safe identifier
- title: Lesson title (max 80 chars)
- type: meditation | audio | video | text | quiz | exercise | interactive
- sortOrder: Numeric position in course
- durationMinutes: Expected completion time
recommended:
- description: Lesson summary
- chapterNumber: Grouping (e.g., Week 1, Day 1)
- chapterTitle: Chapter name
- isPreview: Free preview content
- prerequisites: Array of required lesson IDs
- transcript: Full text transcript
- timedTranscript: Cues with timestamps
Progress Tracking#
Progress is automatically tracked per user:
{
"courseId": "uuid",
"userId": "uuid",
"status": "in_progress | completed",
"completedItems": ["lesson-1", "lesson-2"],
"currentItemId": "lesson-3",
"progressPercentage": 28.5,
"totalTimeSpentMinutes": 45,
"moduleProgress": {
"week-1": { "completed": 3, "total": 7, "percentage": 42.8 }
},
"quizScores": {
"quiz-1": 80
},
"enrolledAt": "2026-01-01T00:00:00Z",
"startedAt": "2026-01-01T10:00:00Z",
"completedAt": null
}
Quality Checklist#
Course Design#
- Clear learning objectives defined
- Progressive skill building structure
- Appropriate duration for difficulty level
- Daily time commitment clearly stated
- One new concept per lesson maximum
- Rest/review days included (14+ day courses)
Lesson Quality#
- Each lesson has clear purpose
- Teaching before practice (technique explanation)
- Appropriate lesson type for content
- Consistent duration within course
- Prerequisites correctly configured
- Transcripts provided for all audio/video
User Experience#
- Preview content available (first lesson or trailer)
- Clear chapter/day organization
- Progress saves correctly
- Offline support for practices
- Works on mobile devices
- Accessible to users with disabilities
Metadata#
- All required fields populated
- SEO title and description optimized
- Thumbnail meets specifications
- Tags relevant and specific (3-7)
- Category correctly assigned
- Difficulty accurately reflects content
Examples#
Good Course Structure#
Course: "7 Days to Calm"
Type: course
Difficulty: beginner
Duration: 70 minutes total (10 min/day)
Day 1: Finding Stillness
├── Welcome Video (2 min) - Sets expectations
├── What is Calm? (text, 1 min) - Simple definition
└── Your First Practice (meditation, 7 min) - Breath awareness
Day 2: Body Awareness
├── The Body-Mind Connection (audio, 2 min) - Teaching
└── Body Scan Basics (meditation, 8 min) - Practice
[...continues with progressive building...]
Day 7: Calm in Daily Life
├── Taking It With You (video, 3 min) - Integration
├── Full Practice (meditation, 12 min) - Culmination
└── Next Steps (text, 1 min) - Future path
Poor Course Structure (What to Avoid)#
Course: "Meditation"
Type: course
Difficulty: all_levels ← Too vague
Day 1: Everything About Meditation
├── 45-minute video with all concepts ← Information overload
└── 30-minute advanced practice ← Too much for beginners
Day 2: Same practice as Day 1 ← No progression
Day 3: Same practice as Day 1 ← No progression
Day 4: New advanced technique with no intro ← Missing prerequisite teaching
Day 5: Quiz with 25 questions ← Too many questions
Day 6: Nothing scheduled ← Breaks rhythm
Day 7: "The End" text only ← No culminating practice
Related Documents#
Sources & References#
- Mindfulness Exercises Curriculum
- Mindworks Meditation Courses
- Guided Meditation Framework
- Class Central - Best Meditation Courses
Last updated: January 2, 2026