Eve library

Course Structure Guidelines

Guide

Revision 1

On this page

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#

  1. Course Types
  2. Course Design Principles
  3. Lesson Types
  4. Course Structure Templates
  5. Progression Design
  6. Content Components
  7. Data Structure Requirements
  8. 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:

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

  1. Opening (1-2 min) - Welcome, context, intention
  2. Teaching (2-5 min) - New concept or technique
  3. Practice (5-20 min) - Guided meditation/exercise
  4. 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)

text
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

text
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

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

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

typescript
// 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 statements
  • short_answer - Brief written response
  • matching - 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#

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

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

json
{
  "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#

text
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)#

text
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


Sources & References#


Last updated: January 2, 2026