# Courses

> Courses of modules and lessons ordered by rank keys, with quiz lessons graded by forms, per-lesson progress, completion and certificates. Each course runs as an enrollment program, so learners enroll through enrollments.

- Category: Content & files
- Module: `courses`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/courses
- Page: https://bettersupabase.com/blocks/courses

## Install

```bash
npx better-supabase add courses
```

The command also installs `updated-at`, `tenant`, `access`, `enrollments`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by courses; add installs them too.
    "updated-at": {},
    tenant: {},
    access: {},
    enrollments: {},
    // Modes: "managed", "custom". The default is "managed".
    courses: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/courses`.

## Events

- `course.completed`
- `course.deleted`
- `course.enrolled`
- `course.saved`
- `course.unenrolled`
- `course_certificate.issued`
- `course_certificate.revoked`
- `course_lesson.completed`

## Related blocks

Requires: [tenant](https://bettersupabase.com/blocks/tenant.md), [access](https://bettersupabase.com/blocks/access.md), [enrollments](https://bettersupabase.com/blocks/enrollments.md)

Works with: [forms](https://bettersupabase.com/blocks/forms.md), [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)

## Recipes

- [Course outline](https://bettersupabase.com/recipes/course-outline.md): A course's modules and lessons in rank order, with the caller's progress, certificate and an Enroll button.
- [Lesson player](https://bettersupabase.com/recipes/lesson-player.md): One lesson's content with a Mark as done button, or its quiz, which the database grades on submit.