Repl Toolkit — Documentation Site

Source for the Repl Toolkit documentation, built with Astro Starlight.

Structure

src/content/docs/
├── getting-started/   # Installation, first app, CLI/REPL/MCP modes, migration guide
├── cookbook/          # Task-focused guides (core basics, modules, prompts, testing, …)
└── reference/         # API-level reference (routes, DI, modules, MCP, data types, …)

The API reference under /api/ is generated by DocFX from the Repl source at build time.

Local development

npm install
npm run dev        # dev server at http://localhost:4321
npm run build      # production build to ./dist/
npm run preview    # preview the production build locally

Deployment

Pushes to main trigger the GitHub Actions workflow (.github/workflows/deploy.yml), which:

1. Resolves the latest Repl release tag.
2. Checks out the Repl source at that tag.
3. Builds the API reference with DocFX.
4. Builds the Astro site.
5. Deploys to GitHub Pages.

A daily scheduled run keeps the API reference in sync with new releases even without a doc change.