Reusable VitePress course builder. The repository contains the builder only; course source content can live outside the repo and is mirrored into docs/courses/ during local dev and build.

• external course source directory: ../course-builder-courses by default
• override source directory: COURSE_SOURCE_DIR=/absolute/or/relative/path
• manifest contract per course: <course-dir>/course.manifest.mjs
• markdown content per course: <course-dir>/docs/<locale>/...
• generated mirror used by VitePress: docs/courses/<slug>/
• generated runtime registry: docs/.vitepress/generated-course-data.mjs

The published site exposes:

• root catalog at /
• one route tree per course at /courses/<slug>/<locale>/...

npm install
npm run courses:sync
npm test
npm run docs:dev
npm run docs:build

Useful course commands:

npm run course:list
npm run course:new -- my-course "My Course"
npm run course:activate -- my-course

Each external course directory should look like:

course-builder-courses/
 my-course/
 course.manifest.mjs
 docs/
 index.md
 en/
 index.md
 lectures/
 projects/
 resources/
 skills/

• courses/ inside this repo is ignored and should not be used as the source of truth.
• docs/courses/ and generated registry files are local build artifacts and are ignored.
• npm test, npm run docs:dev, and npm run docs:build sync external courses before running.