---
title: "Beacon"
description: "An open-source, self-hosted static site generator for documentation, tutorials, and product content."
url: https://beacon-arodoni.vercel.app/
---

# 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 <kbd>⌘</kbd> <kbd>K</kbd> (or <kbd>Ctrl</kbd>
  <kbd>K</kbd>) 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`.