feat(docs): add comprehensive documentation pages and update routing

- Add 6 new markdown documentation files (getting-started, cli-reference, presets, custom-configs, faq, snapshot)
- Create docs route with page component
- Update hooks.server.ts to exclude /docs and /cli-auth from short alias matching
- Fix backdrop z-index in docs page styling
- Update package dependencies

Author: fullstackjam

package-lock.json

@@ -20,5 +20,8 @@
 		"typescript": "^5.9.3",
 		"vite": "^7.3.1",
 		"wrangler": "^4.61.1"
+	},
+	"dependencies": {
+		"marked": "^17.0.1"
 	}
 }

package.json

@@ -0,0 +1,103 @@
+# CLI Reference
+
+The `openboot` command-line tool handles both installation and environment capture.
+
+## Installation Commands
+
+### `openboot`
+
+Run with no arguments to launch the interactive TUI installer. This is the default experience — you'll see a full-screen terminal interface where you can browse and select packages.
+
+```
+openboot
+```
+
+The TUI starts with the `developer` preset pre-selected. Use arrow keys to navigate, Space to toggle packages, and Enter to confirm.
+
+### `openboot --preset <name>`
+
+Install a preset directly. Available presets: `minimal`, `developer`, `full`.
+
+```
+openboot --preset developer
+```
+
+This launches the TUI with the specified preset's packages pre-selected.
+
+### `openboot --user <username>/<slug>`
+
+Install from a remote custom config hosted on openboot.dev.
+
+```
+openboot --user sarah/frontend-team
+```
+
+This fetches the config and launches the TUI with those packages pre-selected.
+
+### `openboot --dry-run`
+
+Preview what would be installed without actually installing anything. Works with any other flag combination.
+
+```
+openboot --preset full --dry-run
+```
+
+Output shows the full list of formulae and casks that would be installed, along with any shell configuration or macOS preference changes.
+
+## Snapshot Commands
+
+### `openboot snapshot`
+
+Capture your current Mac's development environment. Scans Homebrew packages, macOS preferences, shell config, git config, and installed dev tools.
+
+```
+openboot snapshot
+```
+
+By default, this scans your system and then walks you through uploading the result to openboot.dev as a shareable config.
+
+### `openboot snapshot --dry-run`
+
+Preview what would be captured without saving or uploading.
+
+```
+openboot snapshot --dry-run
+```
+
+### `openboot snapshot --json`
+
+Output the snapshot as JSON to stdout. Useful for piping to other tools or inspecting the raw data.
+
+```
+openboot snapshot --json
+openboot snapshot --json | jq '.homebrew.formulae'
+```
+
+### `openboot snapshot --local`
+
+Save the snapshot to `~/.openboot/snapshot.json` instead of uploading to openboot.dev.
+
+```
+openboot snapshot --local
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `OPENBOOT_VERSION` | Override the version of OpenBoot to install | Latest release |
+| `OPENBOOT_INSTALL_DIR` | Override the installation directory for the binary | `/usr/local/bin` or `/opt/homebrew/bin` |
+
+### Example
+
+Install a specific version:
+
+```
+OPENBOOT_VERSION=0.3.1 curl -fsSL openboot.dev/install | bash
+```
+
+Install to a custom directory:
+
+```
+OPENBOOT_INSTALL_DIR=~/.local/bin curl -fsSL openboot.dev/install | bash
+```

src/docs/cli-reference.md

@@ -0,0 +1,61 @@
+# Custom Configurations
+
+Custom configs let you create, save, and share your own package selections. They're stored on openboot.dev and can be installed by anyone with the URL.
+
+## Create an Account
+
+Sign in with GitHub OAuth — click **Login** in the header or visit the dashboard directly. No email/password required.
+
+## Using the Dashboard
+
+Once logged in, go to your **Dashboard** to manage configs.
+
+### Creating a Config
+
+1. Click **Create Config**
+2. Enter a **name** (e.g., "frontend-team") and optional **description**
+3. Choose a **base preset** (minimal, developer, or full) as your starting point
+4. Add or remove individual packages using the package search
+5. Save your config
+
+### Config Options
+
+Each config supports:
+
+- **Homebrew formulae** — CLI tools installed via `brew install`
+- **Homebrew casks** — GUI apps installed via `brew install --cask`
+- **Custom scripts** — Shell commands that run after package installation (e.g., setting up SSH keys, cloning repos)
+- **Dotfiles repo** — A Git URL to your dotfiles repository that gets cloned and stowed
+- **macOS preferences** — Whitelisted system settings (Dock autohide, key repeat speed, etc.)
+
+### Import from Brewfile
+
+Already have a Brewfile? Upload it in the dashboard and OpenBoot will parse it into a config. All `brew` and `cask` entries are extracted and mapped to the config format.
+
+## Sharing Configs
+
+Every config gets a shareable install URL:
+
+```
+curl -fsSL openboot.dev/<username>/<slug>/install | bash
+```
+
+For example, if your GitHub username is `sarah` and your config is named `frontend-team`:
+
+```
+curl -fsSL openboot.dev/sarah/frontend-team/install | bash
+```
+
+Share this URL in your team's README, onboarding docs, or Slack. Anyone who runs it gets your exact setup.
+
+## Public vs Private Configs
+
+- **Public** (default) — anyone can view and install your config
+- **Private** — only you can see the config in the dashboard, but the install URL still works if someone has it
+
+## Custom URL Aliases
+
+Config slugs are auto-generated from the config name, but you can edit them in the dashboard. Keep them short and memorable:
+
+- `openboot.dev/yourname/ios` instead of `openboot.dev/yourname/ios-development-team-2024`
+- `openboot.dev/yourname/ml` instead of `openboot.dev/yourname/machine-learning-setup`

src/docs/custom-configs.md

@@ -0,0 +1,77 @@
+# FAQ
+
+## Is OpenBoot free?
+
+Yes. OpenBoot is free and open source (MIT license) for individuals. You can create custom configs, use snapshot, and share setups at no cost. Team management features (org accounts, access controls) are on the roadmap and may have paid tiers.
+
+## Does it work on Linux?
+
+Partially. The Homebrew-based package installation works on Linux since Homebrew supports Linux (Linuxbrew). However, macOS-specific features don't apply:
+
+- macOS preference tweaks are skipped
+- Cask installations are skipped (casks are macOS-only)
+- Some GUI app detection in snapshot won't work
+
+For Linux, you'll get the CLI tool installations but not the full experience.
+
+## Can I use it for my team?
+
+Yes. The recommended workflow is:
+
+1. Create a custom config on your dashboard with your team's standard tools
+2. Share the one-line install URL in your onboarding docs or README
+3. New team members run the command and get the exact same environment
+
+Alternatively, a team lead can run `openboot snapshot` on their own machine to capture their proven setup and share it directly.
+
+## Is it safe to pipe curl to bash?
+
+This is a common concern. Here's how OpenBoot handles it:
+
+- The install script is **open source** — review it anytime at [github.com/openbootdotdev/openboot](https://github.com/openbootdotdev/openboot)
+- The script is hosted on openboot.dev (Cloudflare Workers) and served over HTTPS
+- **No telemetry** is collected — no analytics, no tracking, no phoning home
+- You can download and inspect the script before running it: `curl -fsSL openboot.dev/install > install.sh && cat install.sh`
+- The binary itself is downloaded from GitHub Releases with checksum verification
+
+## What if I already have Homebrew installed?
+
+OpenBoot detects existing Homebrew installations and skips the Homebrew install step entirely. It also detects already-installed packages and marks them in the TUI so you know what's new versus what's already on your system.
+
+## How do I update OpenBoot?
+
+Re-run the install script:
+
+```
+curl -fsSL openboot.dev/install | bash
+```
+
+This downloads the latest binary and replaces the existing one. Your configs, snapshots, and auth tokens are not affected.
+
+## Where is my data stored?
+
+- **Configs and user data** — stored in Cloudflare D1 (SQLite-compatible database) on openboot.dev's infrastructure
+- **Configs are public by default** — anyone with the URL can install from your config. You can mark configs as private in the dashboard.
+- **Auth tokens** — stored locally at `~/.openboot/auth.json` on your machine
+- **Local snapshots** — saved to `~/.openboot/snapshot.json` when using `--local`
+- **No data is stored on your machine** beyond the binary, auth token, and optional local snapshots
+
+## Can I use OpenBoot without an account?
+
+Yes. You don't need an account to:
+
+- Install using the default presets (`minimal`, `developer`, `full`)
+- Use the interactive TUI
+- Run `openboot snapshot --local` or `openboot snapshot --json`
+
+An account is only needed to upload configs to openboot.dev and share them via URL.
+
+## What shell does OpenBoot configure?
+
+OpenBoot sets up **Zsh** with **Oh-My-Zsh**, including:
+
+- A curated set of plugins (git, zsh-autosuggestions, zsh-syntax-highlighting)
+- A clean theme
+- Useful aliases for common developer tasks
+
+If you already have Oh-My-Zsh installed, OpenBoot merges its plugin recommendations without overwriting your existing configuration.

src/docs/faq.md

@@ -0,0 +1,46 @@
+# Getting Started
+
+OpenBoot is an open-source command-line tool that bootstraps your macOS development environment in minutes. Instead of manually installing Homebrew, CLI tools, GUI apps, configuring your shell, and tweaking macOS settings one by one, OpenBoot handles it all with a single command — through a beautiful interactive TUI that lets you pick exactly what you want.
+
+## System Requirements
+
+- **macOS 12 (Monterey)** or later
+- **Apple Silicon (M1/M2/M3/M4)** and **Intel** Macs are both supported
+- An internet connection (packages are downloaded from Homebrew)
+- Admin privileges (you'll be prompted for your password during install)
+
+## Quick Install
+
+Open Terminal and run:
+
+```
+curl -fsSL https://openboot.dev/install | bash
+```
+
+That's it. One line.
+
+## What Happens When You Run It
+
+Here's exactly what the install script does, in order:
+
+1. **Downloads the OpenBoot binary** — a small Go binary is fetched from the latest GitHub release and placed in `/usr/local/bin` (Intel) or `/opt/homebrew/bin` (Apple Silicon).
+
+2. **Installs Xcode Command Line Tools** — if not already installed, OpenBoot triggers the macOS CLT installer. These are required for Git, compilers, and Homebrew.
+
+3. **Installs Homebrew** — if Homebrew isn't detected, OpenBoot runs the official Homebrew install script. If you already have Homebrew, it skips this step entirely.
+
+4. **Launches the interactive TUI** — a full-screen terminal interface appears where you can browse and toggle packages on/off using your keyboard. You start with the `developer` preset by default, but every package is individually selectable.
+
+5. **Installs your selections** — once you confirm, OpenBoot installs all selected Homebrew formulae and casks, configures Oh-My-Zsh (with plugins and a theme), sets up useful shell aliases, and applies macOS preference tweaks.
+
+## First Run Experience
+
+When the TUI launches, you'll see:
+
+- **Formulae section** — CLI tools grouped by category (essentials, languages, DevOps, etc.)
+- **Casks section** — GUI applications (editors, browsers, utilities, etc.)
+- **Navigation** — use arrow keys and Tab to move between sections, Space to toggle individual packages, Enter to confirm
+
+The TUI shows which packages are already installed on your system (marked with a check) so you won't reinstall anything unnecessarily.
+
+After installation completes, restart your terminal or run `source ~/.zshrc` to pick up the new shell configuration.

src/docs/getting-started.md

@@ -0,0 +1,66 @@
+# Presets
+
+Presets are curated collections of packages designed for different use cases. Each preset is a starting point — when the interactive TUI launches, you can toggle any package on or off before confirming the install.
+
+## Available Presets
+
+### minimal
+
+Lightweight CLI essentials for servers, containers, or developers who prefer a lean setup.
+
+**CLI tools:** curl, wget, jq, yq, ripgrep, fd, bat, eza, fzf, zoxide, htop, btop, tree, tldr, gh, git-delta, lazygit, stow
+
+**GUI apps:** Warp, Raycast, Maccy, Stats
+
+```
+curl -fsSL openboot.dev/install | bash -s -- --preset minimal
+```
+
+### developer (recommended)
+
+A ready-to-code Mac setup with everything you need to start building immediately. Includes all of `minimal` plus languages, Docker, editors, and browsers.
+
+**CLI tools (additions over minimal):** node, go, pnpm, docker, docker-compose, tmux, neovim, httpie
+
+**GUI apps (additions over minimal):** VS Code, OrbStack, Chrome, Arc, Postman, Notion, Scroll Reverser
+
+```
+curl -fsSL openboot.dev/install | bash -s -- --preset developer
+```
+
+### full
+
+The complete dev environment — every language, DevOps tool, database, and AI utility we recommend. Best for polyglot developers, DevOps engineers, or anyone who wants it all.
+
+**CLI tools (additions over developer):** python, uv, rustup, deno, bun, kubectl, helm, k9s, terraform, awscli, sqlite, postgresql, redis, duckdb, ollama, llm
+
+**GUI apps (additions over developer):** Cursor, Firefox, Proxyman, Obsidian, Figma, IINA, Keka, AlDente, Rectangle
+
+```
+curl -fsSL openboot.dev/install | bash -s -- --preset full
+```
+
+## Customizing During Install
+
+You don't have to accept a preset as-is. When the interactive TUI launches:
+
+1. The preset's packages come pre-selected
+2. Use **arrow keys** to navigate the package list
+3. Press **Space** to toggle any package on or off
+4. Press **Enter** to confirm and begin installation
+
+This means you can start with `developer` but add `kubectl` from `full`, or remove `notion` if you don't use it. The preset is just the starting selection.
+
+## Non-Interactive Install
+
+If you want to skip the TUI and install a preset exactly as defined (useful for CI or scripting), the `--preset` flag with no TUI will install everything in the preset without prompting:
+
+```
+curl -fsSL openboot.dev/install | bash -s -- --preset developer
+```
+
+Add `--dry-run` to preview what would be installed without actually installing anything:
+
+```
+curl -fsSL openboot.dev/install | bash -s -- --preset developer --dry-run
+```