feat(web): add mdbook docs with rara theme

- Add 7 user-facing documentation sections
- Create custom mdbook theme matching landing page
- Style code blocks as terminal windows with dot bar
- Apply rara palette to mdbook light theme variables
- Add "get started" CTA linking to docs
- Add outline button style for github link
- Configure vite dev middleware for mdbook output

Users clicking "Get Started" on the landing page now reach
branded documentation that visually matches the site.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: crrow

web/docs/.gitignore

@@ -0,0 +1 @@
+book

web/docs/book.toml

@@ -0,0 +1,11 @@
+[book]
+title = "cli-template"
+authors = ["rararulab"]
+language = "en"
+src = "src"
+
+[output.html]
+additional-css = ["theme/rara.css"]
+default-theme = "light"
+preferred-dark-theme = "light"
+git-repository-url = "https://github.com/rararulab/cli-template"

web/docs/src/README.md

@@ -0,0 +1,26 @@
+# cli-template
+
+A batteries-included Rust CLI template with structured errors, config management, CI/CD pipelines, and automated releases.
+
+## What You Get
+
+- **Clap** argument parsing with derive macros
+- **snafu** structured error handling
+- **tokio** async runtime
+- **tracing** observability
+- **TOML** config system with CLI get/set commands
+- **reqwest** HTTP client singletons
+- **GitHub Actions** CI/CD (lint, test, release)
+- **cargo-dist** cross-platform binary builds
+- **npx** distribution — users run your CLI without Rust installed
+- **Agent-friendly** output: JSON stdout, logs stderr
+
+## Quick Start
+
+```bash
+cargo generate rararulab/cli-template
+cd my-awesome-cli
+cargo run -- --help
+```
+
+See [Getting Started](getting-started.md) for the full walkthrough.

web/docs/src/SUMMARY.md

@@ -0,0 +1,13 @@
+# Summary
+
+[Introduction](README.md)
+
+---
+
+- [Getting Started](getting-started.md)
+- [Project Structure](guide/project-structure.md)
+- [Adding Commands](guide/adding-commands.md)
+- [Error Handling](guide/error-handling.md)
+- [Configuration](guide/configuration.md)
+- [CI/CD & Release](cicd-release.md)
+- [npx Distribution](npx-distribution.md)

web/docs/src/cicd-release.md

@@ -0,0 +1,49 @@
+# CI/CD & Release
+
+## Included Workflows
+
+| Workflow | File | Trigger | Purpose |
+|---|---|---|---|
+| CI | `ci.yml` | PRs | cargo check, test, clippy |
+| Lint | `lint.yml` | PRs | cargo fmt check |
+| Build | `build-binaries.yml` | Release | Cross-platform binary builds via cargo-dist |
+| npm Publish | `publish-npm.yml` | Release | Publish platform packages to npm |
+| Pages | `pages.yml` | Push to main | Deploy `web/` to GitHub Pages |
+
+## Conventional Commits
+
+All commits should follow the format:
+
+```
+type(scope): description (#N)
+```
+
+Accepted types: `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `ci`, `perf`.
+
+Examples:
+
+```
+feat(download): add retry logic (#42)
+fix(config): handle missing file gracefully (#51)
+chore(deps): bump serde to 1.0.200
+```
+
+## Release Flow
+
+1. Merge your PR into `main`.
+2. **release-plz** automatically opens a release PR that bumps the version and updates the changelog.
+3. Merge the release PR.
+4. **cargo-dist** builds binaries for all platforms and creates a GitHub release.
+5. **publish-npm.yml** publishes the npm wrapper packages.
+
+No manual version bumping or tagging required.
+
+## justfile
+
+Run the full pre-commit suite locally:
+
+```bash
+just pre-commit
+```
+
+This runs, in order: `fmt --check`, `clippy`, `doc`, and `test`.

web/docs/src/getting-started.md

@@ -0,0 +1,70 @@
+# Getting Started
+
+## Prerequisites
+
+Install the Rust toolchain and `cargo-generate`:
+
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+cargo install cargo-generate
+```
+
+## Create a Project
+
+```bash
+cargo generate rararulab/cli-template
+```
+
+You'll be prompted for three values:
+
+| Placeholder      | Format     | Example          | Used For                          |
+|------------------|------------|------------------|-----------------------------------|
+| `project-name`   | kebab-case | `my-awesome-cli` | Binary name, directory, npm pkg   |
+| `crate_name`     | snake_case | *(auto-derived)* | Rust module name                  |
+| `github-org`     | —          | `myorg`          | Repo URLs, CI badges              |
+
+> `crate_name` is derived automatically from `project-name` — you rarely need to change it.
+
+## First Run
+
+```bash
+cd my-awesome-cli
+cargo check
+cargo test
+cargo run -- --help
+cargo run -- hello world
+```
+
+The `hello` command is a working example wired end-to-end. Use it as a reference when adding your own commands.
+
+## What to Customize
+
+Once you've verified the template builds, update these files:
+
+- **`CLAUDE.md`** — add a description of your project for AI-assisted development
+- **`Cargo.toml`** — set `description`, `repository`, and `homepage`
+- **`src/cli/mod.rs`** — replace the example `Hello` command with your own
+- **`src/app_config.rs`** — replace `ExampleConfig` with your app's config fields
+- **`README.md`** — rewrite for your project
+
+## Clean Up Example Code
+
+Once your first real command is in place, remove the scaffolding:
+
+1. Delete the `Hello` variant from the `Command` enum in `src/cli/mod.rs`
+2. Delete its match arm in `main.rs`
+3. Replace `ExampleConfig` in `src/app_config.rs` with your own config struct
+
+> Don't delete the example code until you have a real command working. It serves as a reference for the patterns used throughout the template.
+
+## Verify
+
+```bash
+cargo check && cargo test && cargo clippy
+```
+
+All three should pass cleanly before your first commit.
+
+## Next Steps
+
+- [Project Structure](guide/project-structure.md) — understand the module layout and conventions