add-docs-site

What problem does it solve?

Provides a repeatable, production-ready scaffold to add a static Astro Starlight documentation site inside a Rails application so teams can publish end-user documentation without changing Rails routing or infrastructure.

Core Features & Use Cases

• Scaffold and configuration: Creates a docs/ package with astro.config.mjs, package.json, tsconfig, content config, and brandable styles.
• Zero Rails config changes: Builds static HTML to public/docs so Thruster/ActionDispatch serves docs with no routing changes.
• Build, Docker, and CI integration: Adds bun-managed installs, Docker build steps, Procfile.dev entry for the dev server, and a GitHub Actions workflow; includes astro-mermaid for diagrams and guidance to commit bun.lock.
• Content-first Spanish docs: Opinionated sidebar and content structure prioritizing end-user task guides with a collapsible technical reference.

Quick Start

Scaffold an Astro Starlight documentation site inside the Rails app, install bun dependencies, verify the build outputs to public/docs, and add the Docker and CI steps.