chore(web): improve docs

apps/web/content/docs/cli/index.mdx

@@ -1,23 +1,149 @@
 ---
-title: CLI
-description: Command reference index
+title: Commands
+description: Complete reference for all CLI commands
 ---
 
-<Cards>
-  <Card href="/docs/cli/init" title="init">
-    Create a new Better‑T‑Stack project (prompts or --yes)
-  </Card>
-  <Card href="/docs/cli/add" title="add">
-    Add addons or deployment to an existing project
-  </Card>
-  <Card href="/docs/cli/builder" title="builder">
-    Open the web-based Stack Builder
-  </Card>
-  <Card href="/docs/cli/docs" title="docs">
-    Open documentation
-  </Card>
-  <Card href="/docs/cli/sponsors" title="sponsors">
-    View project sponsors
-  </Card>
-</Cards>
+## Overview
 
+The Better-T Stack CLI provides several commands to manage your TypeScript projects.
+
+## `init` (Default Command)
+
+Creates a new Better-T Stack project.
+
+```bash
+create-better-t-stack [project-directory] [options]
+```
+
+### Parameters
+
+- `project-directory` (optional): Name or path for your project directory
+
+### Key Options
+
+- `--yes, -y`: Use default configuration (skips prompts)
+- `--package-manager <pm>`: `npm`, `pnpm`, `bun`
+- `--install / --no-install`: Install dependencies after creation
+- `--git / --no-git`: Initialize Git repository
+- `--frontend <types...>`: Web and/or native frameworks (see [Options](/docs/cli/options#frontend))
+- `--backend <framework>`: `hono`, `express`, `fastify`, `elysia`, `next`, `convex`, `none`
+- `--runtime <runtime>`: `bun`, `node`, `workers` (`none` only with `--backend convex` or `--backend none`)
+- `--database <type>`: `none`, `sqlite`, `postgres`, `mysql`, `mongodb`
+- `--orm <type>`: `none`, `drizzle`, `prisma`, `mongoose`
+- `--api <type>`: `none`, `trpc`, `orpc`
+- `--db-setup <setup>`: `none`, `turso`, `d1`, `neon`, `supabase`, `prisma-postgres`, `mongodb-atlas`, `docker`
+- `--examples <types...>`: `none`, `todo`, `ai`
+- `--web-deploy <setup>`: `none`, `workers`
+
+See the full reference in [Options](/docs/cli/options).
+
+### Examples
+
+```bash
+# Default setup with prompts
+create-better-t-stack 
+
+# Quick setup with defaults
+create-better-t-stack --yes
+
+# Specific configuration
+create-better-t-stack --database postgres --backend hono --frontend tanstack-router
+```
+
+## `add`
+
+Adds addons or deployment configurations to an existing Better-T Stack project.
+
+```bash
+create-better-t-stack add [options]
+```
+
+### Options
+
+- `--addons <types...>`: Addons to add (see [Addons](/docs/cli/options#addons))
+- `--web-deploy <setup>`: Web deployment setup (`workers`, `none`)
+- `--project-dir <path>`: Project directory (defaults to current directory)
+- `--install`: Install dependencies after adding
+- `--package-manager <pm>`: Package manager to use
+
+### Examples
+
+```bash
+# Add addons interactively
+create-better-t-stack add
+
+# Add specific addons
+create-better-t-stack add --addons pwa tauri --install
+
+# Add deployment setup
+create-better-t-stack add --web-deploy workers
+```
+
+## `sponsors`
+
+Displays Better-T Stack sponsors.
+
+```bash
+create-better-t-stack sponsors
+```
+
+Shows a list of project sponsors and supporters.
+
+## `docs`
+
+Opens the Better-T Stack documentation in your default browser.
+
+```bash
+create-better-t-stack docs
+```
+
+Opens `https://better-t-stack.dev/docs` in your browser.
+
+## `builder`
+
+Opens the web-based stack builder in your default browser.
+
+```bash
+create-better-t-stack builder
+```
+
+Opens `https://better-t-stack.dev/new` where you can configure your stack visually.
+
+## Global Options
+
+These options work with any command:
+
+- `--help, -h`: Display help information
+- `--version, -V`: Display CLI version
+
+## Command Examples
+
+### Create a Full-Stack App
+
+```bash
+create-better-t-stack \
+  --database postgres \
+  --orm drizzle \
+  --backend hono \
+  --frontend tanstack-router \
+  --auth \
+  --addons pwa biome
+```
+
+### Create a Backend-Only Project
+
+```bash
+create-better-t-stack api-server \
+  --frontend none \
+  --backend hono \
+  --database postgres \
+  --orm drizzle \
+  --api trpc
+```
+
+### Add Features to Existing Project
+
+```bash
+cd my-existing-project
+create-better-t-stack add --addons tauri starlight --install
+```