Introduction
What Beacon is, who it's for, and how the pieces fit together.
Beacon is a light, branded documentation and changelog starter for indie SaaS and product teams. It pairs an MDX docs site — sidebar, search, and an auto-generated “on this page” table of contents — with a first-class, dated and tagged release feed that ships with RSS out of the box.
It’s built on Astro 5 and Tailwind v4, outputs a fully static site, and has no runtime, no database, and no platform to rent. You own the content and the markup.
Why Beacon
Most docs tools force a tradeoff: either a heavyweight hosted platform you pay monthly for, or a generic theme that looks like every other site on the internet. Beacon takes a third path.
- One fearless color. A single
--color-brandtoken re-skins the entire site. No dark-mode tax — Beacon is light by design. - Content that builds itself. Drop an MDX file in
src/content/docs, declare itsgroupandorder, and the sidebar, search index, and prev/next navigation all update automatically. - A changelog people actually read. Releases are first-class content with colored type badges, tag chips, and an RSS feed.
What’s in the box
| Piece | What it does |
|---|---|
| Docs | MDX pages with a grouped sidebar + TOC |
| Changelog | Dated, tagged release timeline + RSS |
| Search | Zero-dependency client-side search index |
| Branding | One-token recolor, custom lighthouse mark |
Next steps
- Read Installation to get running locally.
- Skim Project Structure to learn where things live.
- Write your first page with Writing Docs.
Beacon is intentionally small. Read the whole thing in fifteen minutes, then make it yours.