@donotdev/cli 0.0.18 → 0.0.20

package/templates/app-demo/tsconfig.json.example

@@ -1,5 +1,5 @@
 {
-  "extends": "../../tsconfig.json",
+  "extends": "../../tsconfig.vite.json",
   "compilerOptions": {
     "baseUrl": ".",
     "types": ["node", "vite/client"]

package/templates/app-demo/vite.config.ts.example

@@ -1,53 +1,28 @@
 // apps/demo/vite.config.ts
-import react from '@vitejs/plugin-react';
-import { defineConfig } from 'vite';
-import tsconfigPaths from 'vite-tsconfig-paths';
-import autoprefixer from 'autoprefixer';
-// @ts-expect-error - postcss-import doesn't have type definitions
-import postcssImport from 'postcss-import';
-import postcssNesting from 'postcss-nesting';
-import { resolve as pathResolve } from 'node:path';
-import { createRequire } from 'node:module';
 
-const require = createRequire(import.meta.url);
+/**
+ * @fileoverview Vite build configuration for the demo app
+ * @description Configures Vite build tool with application settings, development server, HMR, and file watching options for the demo application.
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
 
-export default defineConfig({
-  plugins: [
-    react({
-      jsxRuntime: 'automatic',
-    }),
-    tsconfigPaths({
-      ignoreConfigErrors: true,
-    }),
-  ],
-  css: {
-    postcss: {
-      plugins: [
-        postcssImport({
-          resolve: (id: string, basedir: string) => {
-            // Handle package imports like '@donotdev/components/styles'
-            if (!id.startsWith('.')) {
-              try {
-                return require.resolve(id, { paths: [basedir] });
-              } catch {
-                // Fallback to relative resolution
-                return pathResolve(basedir, id);
-              }
-            }
-            // Relative imports
-            return pathResolve(basedir, id);
-          },
-        }),
-        postcssNesting,
-        autoprefixer,
-      ],
+import { defineViteConfig } from '@donotdev/core/vite';
+
+import { appConfig } from './src/config/app';
+
+// Features and SEO are now in app.ts (runtime config)
+// Only build-time configs (routes, themes, i18n, assets) go here
+export default defineViteConfig({
+  appConfig,
+  server: {
+    port: 3003,
+    https: false,
+
+    // HMR Configuration - Enabled for debugging
+    hmr: {
+      overlay: true, // Show error overlay in browser
     },
   },
-  optimizeDeps: {
-    include: ['react', 'react-dom', 'react/jsx-runtime'],
-  },
-  resolve: {
-    dedupe: ['react', 'react-dom'],
-    preserveSymlinks: false,
-  },
-});
+});

package/templates/app-expo/README.md.example

@@ -8,7 +8,7 @@ Mobile app built with DoNotDev Framework and Expo.
 
 - Node.js 20+ and Bun 1.3+
 - Expo Go app on your phone (for development)
-- Firebase project (run `dndev setup firebase`)
+- Provider configured (run `dndev coach` then `dndev setup`)
 
 ### Development
 

package/templates/app-expo/app/index.tsx.example

@@ -33,7 +33,7 @@ export default function HomePage() {
             <View>
               <Text level="h3">1. Backend Setup</Text>
               <Text level="small">
-                Run: dndev setup
+                Run: dndev coach → fill .env → dndev setup
               </Text>
             </View>
             

package/templates/app-next/src/locales/home_en.json.example

@@ -1,6 +1,6 @@
-{
-  "hero": {
-    "title": "Welcome to DnDev",
-    "subtitle": "Your app is ready. Explore the framework patterns below."
-  }
-}
+{
+  "hero": {
+    "title": "Welcome to DnDev",
+    "subtitle": "Your app is ready. Explore the framework patterns below."
+  }
+}

package/templates/app-vite/src/locales/home_en.json.example

@@ -1,6 +1,6 @@
-{
-  "hero": {
-    "title": "Welcome to DnDev",
-    "subtitle": "Your app is ready. Explore the framework patterns below."
-  }
-}
+{
+  "hero": {
+    "title": "Welcome to DnDev",
+    "subtitle": "Your app is ready. Explore the framework patterns below."
+  }
+}

package/templates/app-vite/src/pages/HomePage.tsx.example

@@ -51,17 +51,15 @@ export default function HomePage() {
           />
 
           <Card
-            title="2. Firebase Setup"
+            title="2. Provider Setup"
             content={[
-              'Run: dndev setup firebase',
-              'This will:',
-              '  - Create or select a Firebase project',
-              '  - Create a web app if needed',
-              '  - Write Firebase config to your .env automatically',
-              '  - Update .firebaserc with your project ID',
-              'Then follow the prompts for the 2 manual steps:',
-              '  - Download service account key',
-              '  - Enable Auth + Firestore in Firebase Console',
+              'Run: dndev coach',
+              'This shows what to configure:',
+              '  - Which dashboard to visit',
+              '  - What to copy and where to paste it',
+              'Fill in your .env values, then run:',
+              '  dndev setup',
+              'Setup validates, automates, and health-checks.',
             ]}
           />
         </Grid>

package/templates/overlay-firebase/env.fragment.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 VITE_FIREBASE_API_KEY=
 VITE_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-firebase/env.fragment.expo.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 EXPO_PUBLIC_FIREBASE_API_KEY=
 EXPO_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-firebase/env.fragment.nextjs.example

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 NEXT_PUBLIC_FIREBASE_API_KEY=
 NEXT_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-supabase/env.fragment.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 VITE_SUPABASE_URL=
 VITE_SUPABASE_PUBLIC_KEY=

package/templates/overlay-supabase/env.fragment.expo.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 EXPO_PUBLIC_SUPABASE_URL=
 EXPO_PUBLIC_SUPABASE_PUBLIC_KEY=

package/templates/overlay-supabase/env.fragment.nextjs.example

@@ -6,7 +6,7 @@
 #   - Project URL: the https://xxx.supabase.co URL
 #   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
 #
-# Then run: dndev setup supabase
+# Then run: dndev setup
 # =============================================================================
 NEXT_PUBLIC_SUPABASE_URL=
 NEXT_PUBLIC_SUPABASE_PUBLIC_KEY=

package/templates/overlay-vercel/env.fragment.example

@@ -3,7 +3,7 @@
 # Firebase Configuration (data layer for Vercel-hosted app)
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 VITE_FIREBASE_API_KEY=
 VITE_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/overlay-vercel/env.fragment.nextjs.example

@@ -3,7 +3,7 @@
 # Firebase Configuration (data layer for Vercel-hosted app)
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
+# Run `dndev coach` to see where to get these, then `dndev setup` to validate
 NEXT_PUBLIC_FIREBASE_API_KEY=
 NEXT_PUBLIC_FIREBASE_PROJECT_ID=
 # Copy from Firebase Console. Framework uses APP_URL hostname in production automatically.

package/templates/root-consumer/AI.md.example

@@ -51,7 +51,7 @@ Skipping these steps means the work is untracked, unvalidated, and unacceptable.
 
 ## CLI Commands
 
-`dndev` is an **installed CLI** (globally via `npm install -g @donotdev/cli`). Run it directly — **never** use `bunx dndev` or `npx dndev`.
+`dndev` is installed globally via `bun install -g` (no sudo needed) and also as a local devDependency. Run it directly — or use `bun run dev` / `bunx dndev` as fallback.
 
 | Command | What it does |
 |---------|-------------|
@@ -65,8 +65,8 @@ Skipping these steps means the work is untracked, unvalidated, and unacceptable.
 | `dndev format` | Format code with Prettier |
 | `dndev deploy` | Deploy to production |
 | `dndev staging` | Deploy to staging/UAT |
-| `dndev setup firebase` | Configure Firebase project + .env |
-| `dndev setup supabase` | Configure Supabase project + .env |
+| `dndev coach` | Show what to configure before running setup |
+| `dndev setup` | Validate .env, automate provider setup, health check |
 | `dndev doctor` | Check project health (providers, .env) |
 | `dndev bump` | Update @donotdev packages to latest |
 | `dndev cacheout` | Clear build caches |
@@ -101,3 +101,4 @@ Key tools: `start_phase` · `complete_phase` · `approve_phase` · `lookup_symbo
 ## Security Gate
 
 Before production: run `dndev doctor` and `/grill`. See `get_guide("SOC2")` for details.
+Golden path: `dndev coach` → fill .env → `dndev setup` → `dndev doctor`.

package/templates/root-consumer/guides/dndev/AGENT_START_HERE.md.example

@@ -16,11 +16,10 @@
 1. **P0 — Prerequisites**
    - **Runtime:** **Node.js 24** (nodejs.org) and **Bun 1.3+** (bun.sh). Both required.
    - **IDE:** Any IDE (Cursor, VS Code, Windsurf, etc.). Need help? Use the collapsible “Need help setting up?” on the Get Started page.
-2. **Install our CLI and create your project’s monorepo**
-   - `npm install -g @donotdev/cli`
-   - `dndev init my-app`
-3. **Open the repo in your IDE, terminal, bun install**
-   - Start your IDE in that repo, open the terminal: `cd my-app` → `bun install`
+2. **Create your project’s monorepo**
+   - `bunx create-donotdev my-app`
+3. **Open the repo in your IDE**
+   - Start your IDE in that repo. Dependencies are already installed.
 4. **Enable MCP, then read AI.md and follow the flow**
    - Talk with your agent; ask it to load the MCP (Cursor: Ctrl+Shift+P → “MCP Server” → enable “donotdev”; other IDEs: see “How to enable MCP” collapsible on the Get Started page).
    - Then have the agent read the root **`AI.md`** and this file (**`guides/dndev/AGENT_START_HERE.md`**). Follow the phases.
@@ -29,6 +28,22 @@
 
 ---
 
+## Demo App — Canonical Reference
+
+**Before building anything, look at the demo app:** `packages/cli/templates/app-demo/`
+
+It demonstrates the correct way to use the framework:
+- Per-route layout switching via `PageMeta.preset` (landing → admin → docs)
+- SaaS pages as thin template wrappers (~5 lines each)
+- Component showcase with filterable grid and detail pages
+- Entity definition with `defineEntity()`
+- Zero custom CSS in page files
+- Auth-guarded routes alongside public routes
+
+**Copy from the demo app, then customize.** Don't invent patterns — the demo app IS the pattern.
+
+---
+
 ## First Thing to Call: list_features()
 
 Call **`list_features()`** before designing or coding. It lists all framework packages with a one-line summary from each README (templates, core, ui, auth, billing, etc.). Use it so you don't reinvent what the framework already provides (blog, CRUD, billing, legal pages, etc.).
@@ -81,7 +96,7 @@ Check that the user has completed environment setup:
 2. Service account key exists? (`service-account-key.json` in app root)
 3. Emulators work? (`dndev emu start` runs without errors)
 
-If not, coach them: "Run `dndev setup firebase` first, then follow the prompts." See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
+If not, coach them: "Run `dndev coach` to see what to configure, fill in the .env values, then run `dndev setup`." See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) or [SETUP_SUPABASE.md](./SETUP_SUPABASE.md).
 
 ---
 

package/templates/root-consumer/guides/dndev/COMPONENTS_ADV.md.example

@@ -1,16 +1,9 @@
-# Advanced Components (@donotdev/adv-comps)
+# Advanced Components (@donotdev/components)
 
-High-level, opinionated, and marketing-focused UI components for DoNotDev framework.
+High-level, opinionated, and marketing-focused UI components from `@donotdev/components`.
 
-## Setup
-
-**IMPORTANT:** You must import the styles in your `globals.css` file:
-
-```css
-@import '@donotdev/adv-comps/styles';
-```
-
-Without this import, components will not have their required CSS styles.
+All advanced components are included in `@donotdev/components` — no additional package needed.
+Styles are automatically included via `@donotdev/components/styles`.
 
 ## Components
 
@@ -19,7 +12,7 @@ Without this import, components will not have their required CSS styles.
 Cinematic 3D text crawl component with lazy loading.
 
 ```tsx
-import { Crawl } from '@donotdev/adv-comps';
+import { Crawl } from '@donotdev/components';
 
 <Crawl
   intro?: ReactNode | string
@@ -39,7 +32,7 @@ import { Crawl } from '@donotdev/adv-comps';
 Production-grade marquee with accessibility, reduced motion support, and smart behavior detection.
 
 ```tsx
-import { Marquee } from '@donotdev/adv-comps';
+import { Marquee } from '@donotdev/components';
 
 <Marquee<T>
   items: T[]
@@ -63,8 +56,8 @@ import { Marquee } from '@donotdev/adv-comps';
 Timeline component with horizontal (desktop) / vertical (mobile) layout. Features animated progress line, glowing nodes, and lift-on-hover cards.
 
 ```tsx
-import { Roadmap } from '@donotdev/adv-comps';
-import type { RoadmapStep } from '@donotdev/adv-comps';
+import { Roadmap } from '@donotdev/components';
+import type { RoadmapStep } from '@donotdev/components';
 
 <Roadmap
   steps: RoadmapStep[]
@@ -88,8 +81,8 @@ interface RoadmapStep {
 Simple scroll-reveal stacked cards. Active card shows full content, stacked cards show only bottom edge with number.
 
 ```tsx
-import { StackedCards } from '@donotdev/adv-comps';
-import type { StackedCardData } from '@donotdev/adv-comps';
+import { StackedCards } from '@donotdev/components';
+import type { StackedCardData } from '@donotdev/components';
 
 <StackedCards
   items: StackedCardData[]
@@ -111,7 +104,7 @@ interface StackedCardData extends ComponentData {
 Reveal component for staggered animations. Features viewport-based visibility detection, directional animations, and customizable stagger delays.
 
 ```tsx
-import { Reveal } from '@donotdev/adv-comps';
+import { Reveal } from '@donotdev/components';
 
 <Reveal
   items: string[] | ReactNode[]
@@ -131,54 +124,13 @@ import { Reveal } from '@donotdev/adv-comps';
 />
 ```
 
-### InspectorGadget
-
-Floating code inspector component. Displays a floating button with Code icon and label that opens a dialog showing the page's source code.
-
-```tsx
-import { InspectorGadget } from '@donotdev/adv-comps';
-
-<InspectorGadget
-  data?: string // Source code string
-  sourcePath?: string // Path to source file (import with ?raw) - overrides data if provided
-  sourceCode?: string // Source code loaded from file
-  language?: string // Code language for syntax highlighting @default 'tsx'
-  title?: string // Dialog title @default 'Page Source'
-  className?: string
-/>
-```
-
-### Breathing Components
-
-Breathing exercise components for meditation and wellness apps.
-
-```tsx
-import { LungsAnimation, BreathingExerciseLayout } from '@donotdev/adv-comps';
-import type { BreathingExerciseDnDevLayoutProps } from '@donotdev/adv-comps';
-
-<BreathingExerciseLayout
-  status?: ReactNode
-  animation: ReactNode
-  instructions: ReactNode
-  debug?: boolean
-  onSkip?: () => void
-  statusValue?: string
-  onRestart?: () => void
-  onResume?: () => void
-  isPaused?: boolean
-  isComplete?: boolean
-/>
-
-<LungsAnimation ... />
-```
-
 ### Carousel
 
 Premium carousel component with lazy loading built-in. Features true infinite circular loop, hardware-accelerated animations, swipe/touch gestures, and autoplay with pause-on-hover.
 
 ```tsx
-import { Carousel } from '@donotdev/adv-comps';
-import type { CarouselProps, CarouselRef } from '@donotdev/adv-comps';
+import { Carousel } from '@donotdev/components';
+import type { CarouselProps, CarouselRef } from '@donotdev/components';
 
 <Carousel<T>
   items: T[]
@@ -196,100 +148,13 @@ import type { CarouselProps, CarouselRef } from '@donotdev/adv-comps';
 />
 ```
 
-### ComparisonGrid
-
-Comparison grid component for displaying feature comparisons. Provides lazy-loaded content with skeleton loading states.
-
-```tsx
-import { ComparisonGrid } from '@donotdev/adv-comps';
-import type { ComparisonItem } from '@donotdev/adv-comps';
-
-<ComparisonGrid
-  title?: string
-  items: ComparisonItem[]
-  gridCols?: 1 | 2 | 3 | 4 // @default 2
-  className?: string
-  ariaLabel?: string
-/>
-
-// ComparisonItem interface:
-interface ComparisonItem {
-  useCase: string
-  bestFit: string
-  dndev: string
-  reason: string
-}
-```
-
-### CongratulationsCard
-
-Card component for displaying congratulatory messages. Features customizable icon and text with centered layout.
-
-```tsx
-import { CongratulationsCard } from '@donotdev/adv-comps';
-
-<CongratulationsCard
-  text: string
-  icon?: ReactNode // @default '🎉'
-  className?: string
-/>
-```
-
-### GuideModal
-
-Modal component for displaying guides and tutorials. Provides step-by-step guide display with navigation, progress tracking, and completion handling.
-
-```tsx
-import { GuideModal } from '@donotdev/adv-comps';
-import type { GuideModalProps, GuideTemplate } from '@donotdev/adv-comps';
-
-<GuideModal
-  open: boolean
-  onOpenChange: (open: boolean) => void
-  guide: GuideTemplate
-  icon?: LucideIcon
-/>
-
-// GuideTemplate interface:
-interface GuideTemplate {
-  title: string
-  subtitle: string
-  quickStart?: {
-    title: string
-    code: string
-    description: string
-  }
-  steps?: GuideStep[]
-  features?: string[]
-  templates?: Array<{
-    name: string
-    description: string
-  }>
-  actions?: Array<{
-    label: string
-    href: string
-    variant?: 'default' | 'outline'
-    icon?: LucideIcon
-  }>
-}
-
-// GuideStep interface:
-interface GuideStep {
-  icon: LucideIcon
-  title: string
-  description: string
-  code?: string
-  details?: string
-}
-```
-
 ### SplitReveal
 
 Split reveal component for displaying content in two columns. Features left column content and right column stat cards or custom content with reveal animations.
 
 ```tsx
-import { SplitReveal } from '@donotdev/adv-comps';
-import type { StatCardData } from '@donotdev/adv-comps';
+import { SplitReveal } from '@donotdev/components';
+import type { StatCardData } from '@donotdev/components';
 
 <SplitReveal
   left: ReactNode
@@ -307,34 +172,6 @@ interface StatCardData {
 }
 ```
 
-### StartChallengeForm
-
-Generic form layout component for input + CTA button patterns.
-
-```tsx
-import { StartChallengeForm } from '@donotdev/adv-comps';
-
-<StartChallengeForm
-  input={{
-    value: string
-    onChange: (value: string) => void
-    placeholder?: string
-    label?: string
-    maxLength?: number
-    className?: string
-  }}
-  button={{
-    label: string
-    onClick: () => void
-    icon?: ComponentType<{ className?: string }>
-    variant?: ButtonVariant
-    className?: string
-  }}
-  size?: 'sm' | 'md' | 'lg'
-  className?: string
-/>
-```
-
 ## Notes
 
 - All components are lazy-loaded by default for optimal performance
@@ -346,7 +183,7 @@ import { StartChallengeForm } from '@donotdev/adv-comps';
 
 FAQ section component for displaying frequently asked questions using accordion. Reads FAQ items from i18n JSON files.
 
-**Note:** This component is from `@donotdev/core`, not `@donotdev/adv-comps`. It requires i18n setup with translation files.
+**Note:** This component is from `@donotdev/core`, not `@donotdev/components`. It requires i18n setup with translation files.
 
 ```tsx
 import { FAQSection, useTranslation } from '@donotdev/core';

package/templates/root-consumer/guides/dndev/ENV_SETUP.md.example

@@ -10,12 +10,13 @@ If you haven’t run `dndev init` yet, see [AGENT_START_HERE.md](./AGENT_START_H
 
 ```
 bun install                    → install dependencies
-dndev dev                        -> start app, read the homepage setup guide
-dndev setup firebase           -> configure Firebase project + .env
-  -- or --
-dndev setup supabase           -> configure Supabase project + .env
-dndev emu start                -> test locally with emulators (Firebase)
-dndev deploy                   -> deploy to production
+dndev dev                      → start app, read the homepage setup guide
+dndev coach                    → see what to configure (numbered checklist)
+  (fill in .env values from dashboard)
+dndev setup                    → validate .env, automate provider config
+dndev doctor                   → health check
+dndev emu start                → test locally with emulators (Firebase)
+dndev deploy                   → deploy to production
 ```
 
 ---
@@ -49,31 +50,27 @@ git push -u origin main
 
 ## Step 3: Backend Setup
 
-### Firebase
+### 1. See what to configure
 
 ```bash
-dndev setup firebase
+dndev coach
 ```
 
-Automates: project selection/creation, web app, SDK config -> `.env`, `.firebaserc`.
+Prints a numbered checklist: which dashboard to visit, what to copy, where to paste it. No automation, no prompts.
 
-Then 2 manual steps (CLI gives you direct links):
-1. Download service account key -> save as `service-account-key.json`
-2. Enable Auth + Firestore in Firebase Console
+### 2. Fill in .env values
 
-See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) for full details.
+Follow the coach checklist. Paste credentials from your provider dashboards into the appropriate `.env` files.
 
-### Supabase
+### 3. Run setup
 
 ```bash
-dndev setup supabase
+dndev setup
 ```
 
-Asks for your **public** project URL and anon key (both safe to share -- shipped in client bundle).
+Validates all required env vars are present, runs provider automation (CLI linking, migrations, etc.), and runs an inline health check. If values are missing, it tells you which ones and points you back to `dndev coach`.
 
-Get them from: https://supabase.com/dashboard -> your project -> Settings -> API
-
-See [SETUP_SUPABASE.md](./SETUP_SUPABASE.md) for full details (tables, RLS, `dndev generate sql`). See [Secrets Philosophy](#secrets-philosophy) for how we handle secret keys.
+See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) or [SETUP_SUPABASE.md](./SETUP_SUPABASE.md) for full details. See [Secrets Philosophy](#secrets-philosophy) for how we handle secret keys.
 
 ---
 
@@ -188,8 +185,9 @@ my-project/
 |---------|-------------|
 | `dndev dev` | Start dev server |
 | `dndev emu start` | Start Firebase emulators |
-| `dndev setup firebase` | Configure Firebase project + .env |
-| `dndev setup supabase` | Configure Supabase project + .env |
+| `dndev coach` | Show what to configure (numbered checklist) |
+| `dndev setup` | Validate .env, automate provider config, health check |
+| `dndev doctor` | Check project health (providers, .env) |
 | `dndev deploy` | **Firebase:** hosting + functions + rules. **Supabase:** deploys frontend to [Vercel](https://vercel.com) (via scaffolded vercel.json) and Edge Functions to Supabase. Set `VITE_SUPABASE_*` in Vercel project env. |
 | `dndev staging` | Deploy to staging environment |
 | `dndev sync-secrets` | Push functions/.env to runtime (Firebase/Vercel) |