@donotdev/cli 0.0.15 → 0.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,
@@ -30,7 +30,7 @@
     "build": "dndev bundle --package @donotdev/cli",
     "dev": "tsc --watch",
     "clean": "rimraf dist tsconfig.tsbuildinfo",
-    "type-check": "tsc --noEmit"
+    "type-check": "bunx tsc --noEmit"
   },
   "dependencies": {
     "@clack/prompts": "^1.0.1",

package/templates/app-expo/.env.example

@@ -28,29 +28,9 @@ EXPO_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # EXPO_PUBLIC_SPOTIFY_CLIENT_ID=your_spotify_client_id
 
 # =============================================================================
-# Firebase Configuration
+# Backend-specific vars are appended below by your backend choice
+# (Firebase, Supabase, etc.) — see overlay templates
 # =============================================================================
-# Get these values from your Firebase project settings
-# Run `dndev firebase:setup` to auto-populate, or copy from Firebase Console
-EXPO_PUBLIC_FIREBASE_API_KEY=
-EXPO_PUBLIC_FIREBASE_PROJECT_ID=
-EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN=
-EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET=
-EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=
-EXPO_PUBLIC_FIREBASE_APP_ID=
-EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID=
-EXPO_PUBLIC_FIREBASE_FUNCTIONS_REGION=
-
-# =============================================================================
-# Firebase Emulator (Development only)
-# =============================================================================
-# Set to true to use Firebase emulators instead of production services
-EXPO_PUBLIC_USE_FIREBASE_EMULATOR=false
-EXPO_PUBLIC_FIREBASE_EMULATOR_HOST=localhost
-EXPO_PUBLIC_FIREBASE_EMULATOR_PORT=9099
-EXPO_PUBLIC_FIREBASE_AUTH_EMULATOR_HOST=http://localhost:9099
-EXPO_PUBLIC_FIREBASE_FIRESTORE_EMULATOR_HOST=localhost:8080
-EXPO_PUBLIC_FIREBASE_FUNCTIONS_EMULATOR_PORT=5001
 
 # =============================================================================
 # Stripe Configuration (if using billing)

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 firebase:setup`)
+- Firebase project (run `dndev setup firebase`)
 
 ### Development
 

package/templates/app-expo/src/config/app.ts.example

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Application Configuration (Expo)
+ *
+ * THIS FILE IS YOUR MAIN CONFIGURATION. Update the values below.
+ *
+ * QUICK START:
+ * 1. Set APP_NAME and APP_SHORT_NAME
+ * 2. Run `bun dev` - everything else is automatic
+ */
+
+import type { AppConfig } from '@donotdev/core';
+
+// ============================================================================
+// APP IDENTITY - Update these values
+// ============================================================================
+
+export const APP_NAME = '{{appName}}';
+export const APP_SHORT_NAME = '{{appShortName}}';
+export const APP_DESCRIPTION = 'Built with DoNotDev Framework';
+
+// ============================================================================
+// MAIN CONFIGURATION
+// ============================================================================
+
+export const appConfig: AppConfig = {
+  app: {
+    name: APP_NAME,
+    shortName: APP_SHORT_NAME,
+    description: APP_DESCRIPTION,
+  },
+
+  // ==========================================================================
+  // FEATURES - Uncomment to enable
+  // ==========================================================================
+  features: {
+    // debug: true, // Enable debug tools in development
+  },
+
+  // ==========================================================================
+  // AUTH CONFIG - Uncomment to customize
+  // ==========================================================================
+  // auth: {
+  //   authRoute: '/signin',
+  //   profilePath: '/profile',
+  // },
+};

package/templates/app-expo/src/config/providers.ts.example

@@ -0,0 +1,7 @@
+// src/config/providers.ts — Provider bootstrap
+// Auto-generated by DoNotDev scaffolding. Edit freely.
+// When you add a backend (Firebase, Supabase), replace this file with the appropriate provider setup.
+// See: guides/dndev/SETUP_PROVIDERS.md
+
+// No backend configured — nothing to register.
+// To add a backend later, run: dndev create-app (in an existing project, it merges)

package/templates/app-next/src/config/providers.ts.example

@@ -0,0 +1,7 @@
+// src/config/providers.ts — Provider bootstrap
+// Auto-generated by DoNotDev scaffolding. Edit freely.
+// When you add a backend (Firebase, Supabase), replace this file with the appropriate provider setup.
+// See: guides/dndev/SETUP_PROVIDERS.md
+
+// No backend configured — nothing to register.
+// To add a backend later, run: dndev create-app (in an existing project, it merges)

package/templates/app-vite/src/config/providers.ts.example

@@ -0,0 +1,7 @@
+// src/config/providers.ts — Provider bootstrap
+// Auto-generated by DoNotDev scaffolding. Edit freely.
+// When you add a backend (Firebase, Supabase), replace this file with the appropriate provider setup.
+// See: guides/dndev/SETUP_PROVIDERS.md
+
+// No backend configured — nothing to register.
+// To add a backend later, run: dndev create-app (in an existing project, it merges)

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

@@ -53,7 +53,7 @@ export default function HomePage() {
           <Card
             title="2. Firebase Setup"
             content={[
-              'Run: dndev firebase:setup',
+              'Run: dndev setup firebase',
               'This will:',
               '  - Create or select a Firebase project',
               '  - Create a web app if needed',

package/templates/functions-firebase/README.md.example

@@ -76,7 +76,7 @@ GITHUB_REPO_NAME=your-repo
 
 # Firebase Configuration
 FIREBASE_PROJECT_ID=your-project-id
-FIREBASE_REGION=us-central1
+FIREBASE_REGION={{YOUR_REGION}}
 ```
 
 ### Setup Instructions

package/templates/functions-firebase/functions-firebase/.env.example.example

@@ -35,7 +35,7 @@ STRIPE_WEBHOOK_SECRET=whsec_...
 # Firebase Configuration (auto-detected, rarely needed manually)
 # =============================================================================
 FIREBASE_PROJECT_ID=your-project-id
-FIREBASE_REGION=us-central1
+FIREBASE_REGION={{YOUR_REGION}}
 
 # =============================================================================
 # Development

package/templates/functions-firebase/functions-firebase/README.md.example

@@ -49,7 +49,7 @@ GITHUB_REPO_NAME=your-repo
 
 # Firebase Configuration
 FIREBASE_PROJECT_ID=your-project-id
-FIREBASE_REGION=us-central1
+FIREBASE_REGION={{YOUR_REGION}}
 ```
 
 ### Setup Instructions

package/templates/functions-firebase/functions-firebase/tsconfig.json.example

@@ -1,5 +1,5 @@
 {
-  "extends": "../../../tsconfig.functions.json",
+  "extends": "../../../../tsconfig.functions.json",
   "compilerOptions": {
     "outDir": "./lib",
     "rootDir": "./src",

package/templates/functions-firebase/functions.config.js.example

@@ -14,7 +14,7 @@
 
 export const functionsConfig = {
   defaults: {
-    region: ['us-central1'],
+    region: ['{{YOUR_REGION}}'],
     platform: 'gcfv2',
     labels: { app: '{{APP_NAME}}' },
   },

package/templates/functions-supabase/supabase/config.toml.example

@@ -0,0 +1,59 @@
+# For detailed configuration reference documentation, visit:
+# https://supabase.com/docs/guides/local-development/cli/config
+project_id = "{{projectName}}"
+
+[api]
+enabled = true
+port = 54321
+schemas = ["public", "graphql_public"]
+extra_search_path = ["public", "extensions"]
+max_rows = 1000
+
+[db]
+port = 54322
+shadow_port = 54320
+major_version = 17
+
+[db.pooler]
+enabled = false
+port = 54329
+pool_mode = "transaction"
+default_pool_size = 20
+max_client_conn = 100
+
+[db.migrations]
+enabled = true
+
+[db.seed]
+enabled = true
+sql_paths = ["./seed.sql"]
+
+[auth]
+enabled = true
+site_url = "http://127.0.0.1:3000"
+additional_redirect_urls = ["https://127.0.0.1:3000"]
+jwt_expiry = 3600
+enable_refresh_token_rotation = true
+refresh_token_reuse_interval = 10
+enable_signup = true
+enable_anonymous_sign_ins = false
+minimum_password_length = 6
+
+[auth.email]
+enable_signup = true
+double_confirm_changes = true
+enable_confirmations = false
+
+[storage]
+enabled = true
+file_size_limit = "50MiB"
+
+[edge_runtime]
+enabled = true
+policy = "per_worker"
+inspector_port = 8083
+
+[analytics]
+enabled = true
+port = 54327
+backend = "postgres"

package/templates/functions-supabase/supabase/functions/.env.example

@@ -0,0 +1,13 @@
+# =============================================================================
+# Supabase Edge Functions — Secret Keys (DO NOT COMMIT)
+# =============================================================================
+# Get these from: https://supabase.com/dashboard > your project > Settings
+#
+# Secret key: Settings > API > service_role key (or "Secret key" on new projects)
+# DB URL:     Settings > Database > Connection string > URI
+#
+# These are SERVER-SIDE ONLY. Never expose in client code.
+# =============================================================================
+
+SUPABASE_SECRET_KEY=
+SUPABASE_DB_URL=

package/templates/functions-supabase/supabase/functions/deno.json.example

@@ -0,0 +1,8 @@
+{
+  "imports": {
+    "@donotdev/functions/supabase": "npm:@donotdev/functions/supabase",
+    "@donotdev/core/server": "npm:@donotdev/core/server",
+    "@supabase/supabase-js": "npm:@supabase/supabase-js",
+    "valibot": "npm:valibot"
+  }
+}

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

@@ -3,7 +3,7 @@
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
-# Run `dndev firebase:setup` to auto-populate, or copy from Firebase Console
+# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
 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 firebase:setup` to auto-populate, or copy from Firebase Console
+# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
 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 firebase:setup` to auto-populate, or copy from Firebase Console
+# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
 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

@@ -1,7 +1,12 @@
 
 # =============================================================================
-# Supabase Configuration
+# Supabase Configuration (PUBLIC — safe to commit)
+# =============================================================================
+# Get these from: https://supabase.com/dashboard > your project > Settings > API
+#   - Project URL: the https://xxx.supabase.co URL
+#   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
+#
+# Then run: dndev setup supabase
 # =============================================================================
-# Get these values from your Supabase project settings > API
 VITE_SUPABASE_URL=
-VITE_SUPABASE_ANON_KEY=
+VITE_SUPABASE_PUBLIC_KEY=

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

@@ -1,7 +1,12 @@
 
 # =============================================================================
-# Supabase Configuration
+# Supabase Configuration (PUBLIC — safe to commit)
+# =============================================================================
+# Get these from: https://supabase.com/dashboard > your project > Settings > API
+#   - Project URL: the https://xxx.supabase.co URL
+#   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
+#
+# Then run: dndev setup supabase
 # =============================================================================
-# Get these values from your Supabase project settings > API
 EXPO_PUBLIC_SUPABASE_URL=
-EXPO_PUBLIC_SUPABASE_ANON_KEY=
+EXPO_PUBLIC_SUPABASE_PUBLIC_KEY=

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

@@ -1,7 +1,12 @@
 
 # =============================================================================
-# Supabase Configuration
+# Supabase Configuration (PUBLIC — safe to commit)
+# =============================================================================
+# Get these from: https://supabase.com/dashboard > your project > Settings > API
+#   - Project URL: the https://xxx.supabase.co URL
+#   - Public key:  "Publishable key" (sb_publishable_...) or legacy "anon key" (eyJ...)
+#
+# Then run: dndev setup supabase
 # =============================================================================
-# Get these values from your Supabase project settings > API
 NEXT_PUBLIC_SUPABASE_URL=
-NEXT_PUBLIC_SUPABASE_ANON_KEY=
+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 firebase:setup` to auto-populate, or copy from Firebase Console
+# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
 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 firebase:setup` to auto-populate, or copy from Firebase Console
+# Run `dndev setup firebase` to auto-populate, or copy from Firebase Console
 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

@@ -36,6 +36,21 @@ approve_phase()         → phase done, move to next
 
 Without MCP: read `.d.ts` files directly from `node_modules/@donotdev/*/dist/`.
 
+## CLI Commands
+
+`dndev` is an **installed CLI** (globally via `npm install -g @donotdev/cli`). Run it directly — **never** use `bunx dndev` or `npx dndev`.
+
+| Command | What it does |
+|---------|-------------|
+| `dndev create-app` | Interactive wizard — creates a new app in the monorepo |
+| `dndev dev` | Start the dev server (Vite/Next.js via Turbo) |
+| `dndev emu start` | Start Firebase emulators |
+| `dndev deploy` | Deploy to production |
+| `dndev setup firebase` | Configure Firebase project + .env |
+| `dndev setup supabase` | Configure Supabase project + .env |
+
+`dndev create-app` is **interactive** — it prompts for builder (Vite/Next.js/Expo), backend (Firebase/Supabase/none), and features. There is no `--preset` flag.
+
 ## Rules
 
 - **ESM only** — never `require()`

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

@@ -46,7 +46,7 @@ Call `start_phase(N)` to begin each phase. It returns the blueprint, agent perso
 
 ### Phase 1: SCAFFOLD (Extractor)
 - **MCP:** `start_phase(1)`
-- **Goal:** Running skeleton. Use `dndev create-app` and create `*Page.tsx` stubs.
+- **Goal:** Running skeleton. Run `dndev create-app` (interactive wizard, run directly — never `bunx`) and create `*Page.tsx` stubs.
 
 ### Phase 2: ENTITIES (Architect)
 - **MCP:** `start_phase(2)`
@@ -81,7 +81,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 firebase:setup` first, then follow the prompts." See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
+If not, coach them: "Run `dndev setup firebase` first, then follow the prompts." See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
 
 ---
 

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

@@ -9,11 +9,11 @@ If you haven’t run `dndev init` yet, see [AGENT_START_HERE.md](./AGENT_START_H
 ## The Flow
 
 ```
-bun install                    -> install dependencies
-bun dev                        -> start app, read the homepage setup guide
-dndev firebase:setup           -> configure Firebase project + .env
+bun install                    → install dependencies
+dndev dev                        -> start app, read the homepage setup guide
+dndev setup firebase           -> configure Firebase project + .env
   -- or --
-dndev supabase:setup           -> configure Supabase project + .env
+dndev setup supabase           -> configure Supabase project + .env
 dndev emu start                -> test locally with emulators (Firebase)
 dndev deploy                   -> deploy to production
 ```
@@ -24,7 +24,7 @@ dndev deploy                   -> deploy to production
 
 ```bash
 bun install
-bun dev
+dndev dev
 ```
 
 Open the app. The homepage shows every setup step with instructions.
@@ -52,7 +52,7 @@ git push -u origin main
 ### Firebase
 
 ```bash
-dndev firebase:setup
+dndev setup firebase
 ```
 
 Automates: project selection/creation, web app, SDK config -> `.env`, `.firebaserc`.
@@ -66,14 +66,14 @@ See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) for full details.
 ### Supabase
 
 ```bash
-dndev supabase:setup
+dndev setup supabase
 ```
 
 Asks for your **public** project URL and anon key (both safe to share -- shipped in client bundle).
 
 Get them from: https://supabase.com/dashboard -> your project -> Settings -> API
 
-See [SETUP_SUPABASE.md](./SETUP_SUPABASE.md) for full details (tables, RLS, `dn generate sql`). See [Secrets Philosophy](#secrets-philosophy) for how we handle secret keys.
+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.
 
 ---
 
@@ -186,10 +186,10 @@ my-project/
 
 | Command | What It Does |
 |---------|-------------|
-| `bun dev` | Start dev server |
+| `dndev dev` | Start dev server |
 | `dndev emu start` | Start Firebase emulators |
-| `dndev firebase:setup` | Configure Firebase project + .env |
-| `dndev supabase:setup` | Configure Supabase project + .env |
+| `dndev setup firebase` | Configure Firebase project + .env |
+| `dndev setup supabase` | Configure Supabase project + .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) |
@@ -215,4 +215,4 @@ my-project/
 
 ---
 
-**Start here: `bun install && bun dev`. The homepage tells you everything else.**
+**Start here: `bun install && dndev dev`. The homepage tells you everything else.**

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

@@ -11,8 +11,8 @@
 - **Human flow:** P0 (Bun/Node + AI IDE) → Install CLI & `dndev init` → Run **AI.md** → Enjoy. See [AGENT_START_HERE.md](./AGENT_START_HERE.md) § Getting started (for humans).
 - [ENV_SETUP.md](./ENV_SETUP.md) — After `dndev init`: env, Firebase/Supabase, deploy
 - [GOTCHAS.md](./GOTCHAS.md) - **Common mistakes & pitfalls** (phase-tagged, read before coding)
-- [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) - Firebase project setup (`dndev firebase:setup`)
-- [SETUP_SUPABASE.md](./SETUP_SUPABASE.md) - Supabase project setup (`dndev supabase:setup`, `dn generate sql`)
+- [SETUP_FIREBASE.md](./SETUP_FIREBASE.md) - Firebase project setup (`dndev setup firebase`)
+- [SETUP_SUPABASE.md](./SETUP_SUPABASE.md) - Supabase project setup (`dndev setup supabase`, `dndev generate sql`)
 - [SETUP_TESTING.md](./SETUP_TESTING.md) - Test generation (Phase 4)
 
 ---
@@ -36,7 +36,7 @@
 - [SETUP_BILLING.md](./SETUP_BILLING.md) - Stripe subscriptions (pre-configured)
 - [SETUP_BLOG.md](./SETUP_BLOG.md) - Convention-based markdown blog with i18n
 - [SETUP_PWA.md](./SETUP_PWA.md) - Progressive Web App setup
-- [SETUP_FUNCTIONS.md](./SETUP_FUNCTIONS.md) - Firebase Functions (pre-configured)
+- [SETUP_FUNCTIONS.md](./SETUP_FUNCTIONS.md) - Functions overview (redirects to provider guides)
 
 ---
 

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

@@ -109,14 +109,14 @@ export default defineViteConfig({
 
 **Vite loads `.env` from the app directory only.** Not the repo root.
 
-Run `dndev firebase:setup` to auto-populate Firebase config. See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
+Run `dndev setup firebase` to auto-populate Firebase config. See [SETUP_FIREBASE.md](./SETUP_FIREBASE.md).
 
 ```bash
 # apps/<your-app>/.env — client-side variables (exposed to browser)
 VITE_APP_URL=http://localhost:5173
 VITE_DONOTDEV_LICENSE_KEY=dndev_your_key_here
-VITE_FIREBASE_API_KEY=...          # Written by dndev firebase:setup
-VITE_FIREBASE_PROJECT_ID=...       # Written by dndev firebase:setup
+VITE_FIREBASE_API_KEY=...          # Written by dndev setup firebase
+VITE_FIREBASE_PROJECT_ID=...       # Written by dndev setup firebase
 VITE_AUTH_PARTNERS=github,google
 VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...
 

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

@@ -1,6 +1,6 @@
-# Setup: Authentication (Firebase Auth)
+# Setup: Authentication
 
-**Most is pre-configured.** Firebase Auth for user sign-in/sign-up. Add env vars and config. Framework handles providers, callbacks, sessions.
+**Most is pre-configured.** Works with Firebase Auth or Supabase Auth. Add env vars and config. Framework handles providers, callbacks, sessions.
 
 ---
 
@@ -24,7 +24,8 @@ export const appConfig: AppConfig = {
 };
 ```
 
-**Firebase Console:** Enable providers in Authentication > Sign-in method
+**Firebase:** Enable providers in Firebase Console → Authentication → Sign-in method
+**Supabase:** Enable providers in Supabase Dashboard → Authentication → Providers
 
 ---
 
@@ -80,10 +81,10 @@ const signOut = useAuth('signOut');
 
 **Default:** All authenticated users are `'user'` role.
 
-**Setting admin/super roles:** Set Firebase Auth customClaims:
+**Setting admin/super roles:**
 
+**Firebase** — Set customClaims:
 ```typescript
-// Using Firebase Admin SDK
 import { getFirebaseAdminAuth } from '@donotdev/firebase/server';
 
 const auth = getFirebaseAdminAuth();
@@ -93,12 +94,18 @@ await auth.setCustomUserClaims(userId, {
 });
 ```
 
+**Supabase** — Set user metadata:
+```sql
+-- In Supabase Dashboard → SQL Editor
+UPDATE auth.users SET raw_app_meta_data = raw_app_meta_data || '{"role": "admin"}' WHERE id = '<user-id>';
+```
+
 **Using CLI:**
 ```bash
 dndev make-admin <userId>
 ```
 
-**Note:** User must sign out and sign in again for role changes to take effect (customClaims are in the ID token).
+**Note:** User must sign out and sign in again for role changes to take effect.
 
 **Used by:** CRUD access control, protected routes, field visibility filtering.