Using This Template

This template is built to be cloned, content-swapped, and redeployed. Everything you need to fill is under src/content/. Everything else — components, layouts, the theme pipeline, the routing — is meant to stay untouched.

The shape of a course

A course is a flat list of modules, and each module is a flat list of lessons. Modules live in src/content/modules/NN-slug/. The NN- prefix sets the sort order. Inside each module folder you put one _module.json (title plus order) and one file per lesson.

A lesson is a Markdown or MDX file with a small YAML frontmatter at the top. The frontmatter declares the title, sort order, tags, and whether the lesson is draft or published. Drafts disappear from the built site automatically — they exist only in npm run dev.

Plain Markdown vs MDX

If a lesson is text only, use a plain .md file like this one. The moment you need a video, a callout, a quiz, a prompt box, a download, or a transcript, switch the extension to .mdx and import the block components from ~/components/blocks.

The next lesson, “Changing the Theme”, walks through the eight theme knobs. Module zero’s “Welcome” lesson is a live demo of every block component you can drop into an MDX file. Between the two of them you have a working pattern library to copy from.

When in doubt, read CONTENT_SCHEMA.md. It is the authoritative reference for every field, every prop, every URL pattern.