chore(web): improve docs and readme

Author: AmanVarshney01

README.md

@@ -10,17 +10,24 @@ A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with
 
 ![demo](https://cdn.jsdelivr.net/gh/amanvarshney01/create-better-t-stack/demo.gif)
 
+## Philosophy
+
+- Roll your own stack: you pick only the parts you need, nothing extra.
+- Minimal templates: bare-bones scaffolds with zero bloat.
+- Latest dependencies: always use current, stable versions by default.
+- Free and open source: forever.
+
 ## Quick Start
 
 ```bash
-# Using npm
-npx create-better-t-stack@latest
-
-# Using bun
+# Using bun (recommended)
 bun create better-t-stack@latest
 
 # Using pnpm
 pnpm create better-t-stack@latest
+
+# Using npm
+npx create-better-t-stack@latest
 ```
 
 ## Features
@@ -37,7 +44,7 @@ pnpm create better-t-stack@latest
 - DB Setup: Turso, Neon, Supabase, Prisma PostgreSQL, MongoDB Atlas, Cloudflare D1, Docker
 - Web Deploy: Cloudflare Workers
 
-Type safety end-to-end, clean monorepo layout, and zero‑lock‑in: you choose only what you need.
+Type safety end-to-end, clean monorepo layout, and zero lock-in: you choose only what you need.
 
 ## Repository Structure
 

apps/cli/README.md

@@ -15,14 +15,14 @@ A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with
 Run without installing globally:
 
 ```bash
-# Using npm
-npx create-better-t-stack@latest
-
-# Using bun
+# Using bun (recommended)
 bun create better-t-stack@latest
 
 # Using pnpm
 pnpm create better-t-stack@latest
+
+# Using npm
+npx create-better-t-stack@latest
 ```
 
 Follow the prompts to configure your project or use the `--yes` flag for defaults.
@@ -58,14 +58,15 @@ Options:
   --auth                          Include authentication
   --no-auth                       Exclude authentication
   --frontend <types...>           Frontend types (tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, native-nativewind, native-unistyles, none)
-  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, none)
+  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, fumadocs, ultracite, oxlint, none)
   --examples <types...>           Examples to include (todo, ai, none)
   --git                           Initialize git repository
   --no-git                        Skip git initialization
   --package-manager <pm>          Package manager (npm, pnpm, bun)
   --install                       Install dependencies
   --no-install                    Skip installing dependencies
-  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, none)
+  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, docker, none)
+  --web-deploy <setup>            Web deployment (workers, none)
   --backend <framework>           Backend framework (hono, express, elysia, next, convex, fastify, none)
   --runtime <runtime>             Runtime (bun, node, workers, none)
   --api <type>                    API type (trpc, orpc, none)
@@ -84,7 +85,7 @@ This CLI collects anonymous usage data to help improve the tool. The data collec
 
 ### Disabling Telemetry
 
-You can disable telemetry by setting the `BTS_TELEMETRY` environment variable:
+You can disable telemetry by setting the `BTS_TELEMETRY_DISABLED` environment variable:
 
 ```bash
 # Disable telemetry for a single run
@@ -94,10 +95,6 @@ BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack my-app
 export BTS_TELEMETRY_DISABLED=1
 ```
 
-### Development
-
-During development, telemetry is automatically disabled when `NODE_ENV=development`.
-
 ## Examples
 
 Create a project with default configuration:
@@ -118,10 +115,10 @@ Create a project with Elysia backend and Node.js runtime:
 npx create-better-t-stack my-app --backend elysia --runtime node
 ```
 
-Create a project with multiple frontend options:
+Create a project with multiple frontend options (one web + one native):
 
 ```bash
-npx create-better-t-stack my-app --frontend tanstack-router native
+npx create-better-t-stack my-app --frontend tanstack-router native-nativewind
 ```
 
 Create a project with examples:

apps/web/content/docs/analytics.mdx

@@ -23,10 +23,26 @@ Not collected:
 
 Telemetry is enabled by default. To disable:
 
-```bash
-# Disable for a single run
-BTS_TELEMETRY_DISABLED=1 bun create better-t-stack@latest
-```
+<Tabs items={['bun', 'pnpm', 'npm']}>
+  <Tab value="bun">
+    ```bash
+    # Disable for a single run
+    BTS_TELEMETRY_DISABLED=1 bun create better-t-stack@latest
+    ```
+  </Tab>
+  <Tab value="pnpm">
+    ```bash
+    # Disable for a single run
+    BTS_TELEMETRY_DISABLED=1 pnpm create better-t-stack@latest
+    ```
+  </Tab>
+  <Tab value="npm">
+    ```bash
+    # Disable for a single run
+    BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack@latest
+    ```
+  </Tab>
+</Tabs>
 
 Add `export BTS_TELEMETRY_DISABLED=1` to your shell profile to make it permanent.