Beacon

Beacon is an open-source, self-hosted static site generator for documentation and tutorials. Write pages in MDX, Markdown with JavaScript extension, define your content structure, and Beacon produces plain static HTML, CSS, and JavaScript you can host anywhere.

Beacon supports:

• MDX authoring: Every page lives in content/docs/*.mdx with simple frontmatter.

• Config-driven navigation: Navigation structure, ordering, and grouping all come from content/nav.config.ts.

• Client-side search: Press ⌘ K (or Ctrl K) anywhere on the site to fuzzy-search every page, with no external search service involved.

• Syntax highlighting: Code blocks are highlighted at build time, so no client-side JavaScript is required to render them correctly.

• Dark mode: A theme toggle in the top bar persists your choice across visits.

• Zero server: The build output is static files, with no Node process or database to run. Deploy to Vercel with the default settings.

• Editor: A live Markdown editor under Tools (/dashboard/editor) for drafting and previewing formatting before publishing a page.

• Drift check: A Tools pane that lists suggested fixes for pages that drift out of date, with status badges so you can review, accept, or dismiss each one.

• AI-readable Markdown mirror: Beacon publishes a plain Markdown copy of each page at its URL plus .md, such as /quickstart.md, and lists these copies in /llms.txt.