Good documentation is the difference between a framework people try and a framework people adopt. That's why Stacks treats documentation as a first-class feature, not an afterthought.

Write Docs, Deploy Docs

Every Stacks project comes with a docs/ directory preconfigured. Write your documentation in Markdown, and Stacks builds it into a beautiful static site using BunPress.

./buddy dev:docs    # Preview docs locally
./buddy deploy      # Docs deploy automatically to docs.yoursite.com

What You Get

  • Beautiful defaults: Clean, responsive design with dark mode support
  • Sidebar navigation: Automatically generated from your file structure
  • Syntax highlighting: Code blocks with proper language highlighting
  • Search: Built-in search functionality
  • Automatic deployment: Docs deploy to a dedicated S3 bucket + CloudFront CDN

Powered by BunPress

Under the hood, Stacks uses BunPress — a fast, minimal static site generator built on Bun. It takes your Markdown files and produces optimized HTML with:

  • Table of contents generation
  • Anchor links for headings
  • Responsive images
  • SEO-friendly output with sitemaps and meta tags

Documentation is Part of Your Deploy

When you run ./buddy deploy, your documentation is automatically:

  • Built from the docs/ directory
  • Uploaded to an S3 bucket
  • Served via CloudFront at docs.yourdomain.com
  • Cache-invalidated for instant updates

No separate CI/CD pipeline needed. No extra configuration. It just works.

Start Documenting

Great software deserves great documentation. With Stacks, there's no excuse not to write it.