docs(copy): rewrite all copy to remove AI marketing tone

- Landing page: replace marketing clichés with direct, realistic descriptions
- README: simplify structure, remove excessive formatting, add technical context
- Docs: remove sales-y language, use natural conversational tone
- All pages: replace overpromises with honest expectations (e.g., "10-30 minutes" instead of "minutes")

The goal is to sound like a human describing a real tool, not an AI-generated product launch.

Author: fullstackjam

README.md

@@ -1,133 +1,79 @@
 # openboot.dev
 
-> Website, dashboard, and API for [OpenBoot](https://github.com/openbootdotdev/openboot) — one-line macOS dev environment setup.
+Web dashboard and install API for [OpenBoot](https://github.com/openbootdotdev/openboot).
 
 [![Deploy](https://github.com/openbootdotdev/openboot.dev/actions/workflows/deploy.yml/badge.svg)](https://github.com/openbootdotdev/openboot.dev/actions/workflows/deploy.yml)
 
 **Live at [openboot.dev](https://openboot.dev)**
 
-## What This Repo Does
+This repo handles the web interface for managing configs, serving install scripts, and storing snapshots. The CLI lives at [openbootdotdev/openboot](https://github.com/openbootdotdev/openboot).
 
-- **Landing page** — product overview, presets, install commands
-- **Dashboard** — create, edit, duplicate, and share custom configs
-- **Install API** — serves configs for the OpenBoot CLI
-- **Brewfile import** — parse and convert Brewfiles into OpenBoot configs
-- **Homebrew search** — live package search from the dashboard
-- **CLI auth** — device flow for authenticating the CLI via browser
-- **Snapshot API** — receive and store machine snapshots from the CLI
+## What's in Here
 
-## Tech Stack
+- Landing page + docs (SvelteKit + mdsvex)
+- Dashboard for creating and editing configs
+- Install script generator (the URL you curl from)
+- Brewfile import parser
+- Package search proxies (Homebrew, NPM)
+- OAuth login (GitHub, Google) + CLI device auth flow
+- Snapshot upload API (CLI posts your machine state here)
 
-| Layer | Technology |
-|-------|-----------|
-| Framework | [SvelteKit 5](https://svelte.dev/) + TypeScript |
-| Styling | CSS variables (dark/light theme) |
-| Auth | GitHub & Google OAuth |
-| Database | Cloudflare D1 (SQLite) |
-| Hosting | Cloudflare Workers + Pages |
+## Stack
 
-## Development
+SvelteKit 5 + TypeScript, Cloudflare Workers + D1 (SQLite), GitHub/Google OAuth.
+
+## Running Locally
 
 ```bash
 npm install
-
-# Apply all migrations automatically
-wrangler d1 migrations apply openboot --local
-
+wrangler d1 migrations apply openboot --local  # Sets up DB
 npm run dev
 ```
 
-Create a `.dev.vars` file:
+Create `.dev.vars` with your OAuth credentials:
 
 ```
-GITHUB_CLIENT_ID=your_github_client_id
-GITHUB_CLIENT_SECRET=your_github_client_secret
+GITHUB_CLIENT_ID=...
+GITHUB_CLIENT_SECRET=...
+GOOGLE_CLIENT_ID=...
+GOOGLE_CLIENT_SECRET=...
 ```
 
 ## Deployment
 
-Automatic on push to `main` via GitHub Actions.
+Push to `main` and GitHub Actions deploys to Cloudflare. Runs migrations before deploying code.
 
-```bash
-npm run build
-wrangler deploy
-```
+Secrets needed: `CLOUDFLARE_API_TOKEN`, `CLOUDFLARE_ACCOUNT_ID`
 
-GitHub repository secrets required: `CLOUDFLARE_API_TOKEN`, `CLOUDFLARE_ACCOUNT_ID`
-
-## API Endpoints
-
-### Install Scripts
-
-| Endpoint | Description |
-|----------|-------------|
-| `GET /install` | Default install script |
-| `GET /:alias` | Install script for short alias |
-| `GET /:username/:slug/install` | Install script for specific config |
-| `GET /:username/:slug/config` | Config JSON for CLI consumption |
-
-### Auth
-
-| Endpoint | Description |
-|----------|-------------|
-| `GET /api/auth/login` | GitHub/Google OAuth login redirect |
-| `GET /api/auth/callback/github` | GitHub OAuth callback |
-| `GET /api/auth/callback/google` | Google OAuth callback |
-| `GET /api/auth/logout` | Clear session |
-| `POST /api/auth/cli/start` | Start CLI device auth flow |
-| `POST /api/auth/cli/approve` | Approve CLI auth request |
-| `GET /api/auth/cli/poll` | Poll CLI auth status |
-
-### Configs
-
-| Endpoint | Description |
-|----------|-------------|
-| `GET /api/user` | Current user info |
-| `GET /api/configs` | List user's configs |
-| `POST /api/configs` | Create config |
-| `GET /api/configs/:slug` | Get config by slug |
-| `PUT /api/configs/:slug` | Update config |
-| `DELETE /api/configs/:slug` | Delete config |
-| `POST /api/configs/from-snapshot` | Create config from CLI snapshot |
-
-### Utilities
-
-| Endpoint | Description |
-|----------|-------------|
-| `POST /api/brewfile/parse` | Parse Brewfile content into packages |
-| `GET /api/homebrew/search?q=` | Search Homebrew packages |
-| `GET /api/npm/search?q=` | Search NPM packages |
-
-## Database Schema
-
-```sql
-CREATE TABLE users (
-  id TEXT PRIMARY KEY,
-  github_id TEXT UNIQUE,
-  username TEXT UNIQUE,
-  email TEXT,
-  avatar_url TEXT,
-  created_at TEXT
-);
-
-CREATE TABLE configs (
-  id TEXT PRIMARY KEY,
-  user_id TEXT,
-  slug TEXT,
-  name TEXT,
-  description TEXT,
-  base_preset TEXT,
-  packages TEXT,
-  custom_script TEXT,
-  dotfiles_repo TEXT,
-  snapshot TEXT,
-  alias TEXT UNIQUE,
-  visibility TEXT DEFAULT 'unlisted',
-  install_count INTEGER DEFAULT 0,
-  created_at TEXT,
-  updated_at TEXT
-);
-```
+## Key Endpoints
+
+**Install scripts** (what the CLI curls):
+- `GET /:alias` — Short alias redirect or install script (curl-detected)
+- `GET /:username/:slug/install` — Config install script
+- `GET /:username/:slug/config` — Config JSON for CLI
+
+**Configs** (CRUD for dashboard):
+- `GET/POST /api/configs` — List/create
+- `GET/PUT/DELETE /api/configs/:slug` — Read/update/delete
+- `POST /api/configs/from-snapshot` — CLI snapshot upload
+
+**Auth**:
+- OAuth callbacks at `/api/auth/callback/{github,google}`
+- CLI device flow: `/api/auth/cli/{start,approve,poll}`
+
+**Utilities**:
+- `POST /api/brewfile/parse` — Brewfile → package list
+- `GET /api/homebrew/search?q=...` — Search Homebrew
+- `GET /api/npm/search?q=...` — Search NPM
+
+## Database
+
+D1 (SQLite). Two tables: `users` and `configs`. See `migrations/` for schema. Key fields:
+
+- `configs.packages` — JSON array of {name, type, desc}
+- `configs.snapshot` — JSON object from CLI `openboot snapshot`
+- `configs.visibility` — `public` | `unlisted` | `private`
+- `configs.alias` — short URL (e.g., `openboot.dev/dev` → redirects)
 
 ## Related
 

src/docs/custom-configs.md

@@ -11,11 +11,11 @@ Build your own setup, save it on openboot.dev, and share it as a one-line instal
 
 ## Creating a Config
 
-1. **Sign in** with GitHub or Google — click **Login** in the header (no email/password needed)
-2. Go to your **[Dashboard](/dashboard)**
+1. Sign in with GitHub or Google—click **Login** in the header
+2. Go to your [Dashboard](/dashboard)
 3. Click **Create Config**
-4. Pick a **base preset** (`minimal`, `developer`, or `full`) as your starting point
-5. **Add or remove packages** using the search
+4. Pick a base preset (`minimal`, `developer`, or `full`) to start from
+5. Add or remove packages using search
 6. Save
 
 ## What a Config Can Include
@@ -36,13 +36,13 @@ Already have a Brewfile? Upload it in the dashboard. OpenBoot parses all `brew`
 
 ## Sharing
 
-Every config gets a URL:
+Every config gets an install command:
 
 ```bash
 openboot install sarah/frontend-team
 ```
 
-Put it in your README, onboarding docs, or Slack. One command, same environment for everyone.
+Put it in your README, onboarding docs, or Slack. One command, everyone gets the same setup.
 
 ## Visibility
 

src/docs/faq.md

@@ -9,13 +9,13 @@ order: 12
 
 ## Is OpenBoot free?
 
-Yes — free and open source (MIT license). Create configs, use snapshot, share setups, all at no cost. Team management features (org accounts, access controls) are on the roadmap and may have paid tiers.
+Yes. Free and open source (MIT license). Create configs, snapshot your setup, share with your team—no cost. Team management features (org accounts, access controls) might have paid tiers later.
 
 ## Why not just use Homebrew directly?
 
-Homebrew installs packages. OpenBoot sets up your **entire** environment — packages, GUI apps, shell configuration, dotfiles, and macOS preferences — in one command. Think of it as Homebrew + shell setup + dotfiles + system preferences, orchestrated together with an interactive TUI for picking what you want.
+Homebrew installs packages. OpenBoot installs packages **and** configures your shell, links dotfiles, and applies macOS preferences. All in one run with a TUI to pick what you want.
 
-If you're happy managing each of those separately, you don't need OpenBoot. If you'd rather do it in 5 minutes instead of an hour, give it a try.
+If you're fine managing those separately, you don't need this. If you'd rather automate it, try OpenBoot.
 
 ## Should I use Homebrew or the one-line installer?
 
@@ -33,12 +33,12 @@ Both methods install the exact same binary.
 
 ## Is the one-line installer safe?
 
-Fair question. Here's how OpenBoot handles it:
+Fair question. Here's how it works:
 
-- The install script is **open source** — review it at [github.com/openbootdotdev/openboot](https://github.com/openbootdotdev/openboot)
+- Install script is open source—review it at [github.com/openbootdotdev/openboot](https://github.com/openbootdotdev/openboot)
 - Hosted on openboot.dev (Cloudflare Workers), served over HTTPS
-- **Zero telemetry** — no analytics, no tracking, no phoning home
-- The binary is downloaded from GitHub Releases with **SHA256 checksum verification**
+- Zero telemetry—no analytics, no tracking, nothing phones home
+- Binary downloaded from GitHub Releases with SHA256 checksum verification
 - You can inspect the script before running it:
 
 ```bash

src/docs/presets.md

@@ -7,7 +7,7 @@ order: 3
 
 # Presets
 
-Three curated starting points. Pick one, then customize it in the TUI before installing — add what you want, remove what you don't.
+Three curated package sets. Pick one and customize it in the TUI before installing—add what you need, remove what you don't.
 
 ## At a Glance
 
@@ -41,7 +41,7 @@ curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset minimal
 
 ## developer
 
-The recommended starting point. Everything you need to start building, nothing you don't.
+Default preset. What most developers need without extra stuff you won't use.
 
 **Adds over minimal:**
 - **CLI:** node, go, pnpm, docker, docker-compose, lazydocker, tmux, neovim, httpie, pre-commit
@@ -81,16 +81,16 @@ curl -fsSL https://openboot.dev/install.sh | bash -s -- --preset full
 ```
 </details>
 
-## Customizing During Install
+## Customizing Before Install
 
-Presets are just the starting selection. When the TUI launches:
+Presets are starting selections, not locked-in choices. When the TUI opens:
 
-1. The preset's packages come **pre-selected**
-2. Use **arrow keys** to navigate, **Tab** to switch between formulae and casks
-3. Press **Space** to toggle any package on or off
-4. Press **Enter** to confirm and install
+1. Preset packages are pre-selected
+2. **Arrow keys** to navigate, **Tab** to switch between formulae and casks
+3. **Space** to toggle any package on or off
+4. **Enter** to confirm and start installing
 
-Want `developer` but with `kubectl`? Select `developer`, then toggle `kubectl` on. Don't use Notion? Toggle it off. The preset is the starting point, not the final answer.
+Want `developer` with `kubectl` added? Pick `developer`, then toggle `kubectl` on. Don't use Notion? Toggle it off. Customize before you commit.
 
 ## Skipping the TUI