Stacks / Docs

Easy

Docusaurus / Starlight

Product docs you build. Docusaurus is MIT; Starlight is MIT — ReadMe or Mintlify without the hosted docs seat.

The problem

ReadMe and Mintlify are hosted developer-docs desks. You wanted a docs site you build and serve. Docusaurus is MIT (facebook/docusaurus; last push 23 Oct 2026). Starlight is MIT (withastro/starlight; last push 24 Oct 2026) — an Astro docs theme. This is not ReadMe's every hub, changelog, or API explorer SKU, and not Mintlify's every AI search SKU. An OpenAPI reference stays on /replace/swaggerhub (Scalar). A team wiki stays on /replace/notion (Docmost). A static marketing site stays on /replace/github-pages (Hugo).

Replaces

ReadMe / Mintlify

Replace ReadMe Replace Mintlify See all best open-source API documentation tools

Estimated SaaS saved

$1,200

per year, small team, before lock-in

Start on Railway

Hugo if this is a marketing site, not product docs

Sponsor this stack Tip jar

Placeholder: a Docusaurus or Starlight static build served by Caddy (or any static host). Bind HTTP to 0.0.0.0:$PORT. No one-click template in this repo yet — Start on Railway. OpenAPI stays on /stacks/scalar-api-docs. A wiki stays on /stacks/docmost-wiki.

The stack

Cost table

You stop payingTypical / yearSelf-host instead
ReadMe / Mintlify (small team)$1,200Docusaurus or Starlight + a static host

Agent setup prompt

Replace ReadMe or Mintlify with Docusaurus (preferred) or Starlight.

- Official docs. Build one site. Serve the static output. Do not claim ReadMe hubs, changelogs, or Mintlify AI search.
- Starlight if you already live in Astro — /compare/docusaurus-vs-starlight. OpenAPI stays on /stacks/scalar-api-docs.
- Write AGENT_PROMPT.md.

Also as markdown: /stacks/docusaurus-docs.md

FAQ

Docusaurus or Starlight?
Docusaurus if you want the published ReadMe / Mintlify path. Starlight if you want that Astro theme — /compare/docusaurus-vs-starlight.
Is this SwaggerHub?
No. An OpenAPI reference stays on /replace/swaggerhub (Scalar). This page is product docs.
Is this GitBook?
A team wiki stays on /replace/gitbook (Docmost). This page is a docs site you build.
Are these free?
Docusaurus and Starlight are MIT. You pay hosting. Template users never pay c17.