docs.janus-lang.org

Official documentation for the Janus programming language.

Live: docs.janus-lang.org

Structure

src/content/docs/
├── learn/           8 pages — introduction, quick start, profiles, fundamentals
├── tutorials/       4 pages — hello-to-production, CLI tool, errors, Zig interop
├── reference/       4 pages — error doctrine, UFCS, grafting, filesystem
├── architecture/    3 pages — ASTDB, lexer, diagnostics
├── philosophy/      5 pages — manifesto, bedrock, pragmatism, vision, symbology
└── index.mdx        Landing page

Development

npm install
npm run dev          # Local dev server at localhost:4321
npm run build        # Production build to ./dist/

Deployment

Hosted on Cloudflare Pages. Deploy with:

npx wrangler pages deploy dist --project-name=janus-docs

Stack

• Starlight (Astro) — documentation framework
• Pagefind — client-side search (built-in)
• Expressive Code — syntax highlighting (Janus aliased to Zig)
• Cloudflare Pages — hosting + CDN

License

Content: Libertaria Unbound License (LUL-1.0)