GitHub GitHub GitHub

Introduction

Quickstart

Why ReallySimpleDocs?

There are plenty of existing solutions for creating documentation websites: Mintlify, Fumadocs, Docusaurus, MkDocs... So why create another one?

I wanted something that wasn't bloated. That meant no React. I also wanted it to use the shadcn/ui design system since that's what I use for most of my apps. Finally, I wanted it to be dead simple to use.

So I built ReallySimpleDocs as an Astro integration with Basecoat for the design. You keep your content in docs/, define navigation in docs/docs.json, and let ReallySimpleDocs do the rest.

Key features

  • Fast: Astro builds static docs with minimal client JavaScript.
  • Simple: It's HTML, CSS, and a small amount of vanilla JavaScript.
  • shadcn/ui-compatible: It uses Basecoat, so the docs UI follows shadcn/ui-style markup without requiring React.
  • Portable docs: Keep Markdown pages and navigation in docs/, outside Astro's src/content conventions.
  • AI-friendly: Auto-generated llms.txt, llms-full.txt, and per-page /*.md exports for LLMs.
  • 100% free and open source: I have nothing to sell. No hosting plan, no advanced features. You can host it for free on Cloudflare Pages.

How can I help?

ReallySimpleDocs is 100% open source and free.