@donotdev/cli 0.0.11 → 0.0.13

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B;;;;;GAKG;AAEH,qFAAqF;AACrF,OAAO,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,GAAG,EACH,KAAK,EACL,OAAO,EACP,GAAG,EACH,QAAQ,EACR,WAAW,EACX,MAAM,GACP,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B;;;;;GAKG;AAEH,qFAAqF;AACrF,OAAO,EACL,SAAS,EACT,aAAa,EACb,MAAM,EACN,GAAG,EACH,KAAK,EACL,OAAO,EACP,GAAG,EACH,QAAQ,EACR,WAAW,EACX,MAAM,EACN,OAAO,GACR,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "Command-line interface for DoNotDev Framework",
   "type": "module",
   "private": false,

package/templates/app-demo/src/pages/DetailPage.tsx.example

@@ -78,7 +78,7 @@ export default function DetailPage() {
             .map(([k, v]) => `${k}: ${v}`);
 
           return (
-            <Stack key={idx} gap="medium" align="center">
+            <Stack key={idx} align="center">
               {variantLabels.length > 0 && (
                 <Stack direction="row" gap="tight" wrap="wrap" justify="center">
                   {variantLabels.map((label) => (

package/templates/app-demo/src/pages/FullPage.tsx.example

@@ -81,14 +81,14 @@ export default function FullPage() {
                         default is vertical. Gap controls spacing between items.
                     </Text>
                 </Card>
-                <Stack gap="medium">
+                <Stack>
                     <Card variant="muted" title="Stack Item 1">
-                        <Text variant="muted">Vertical stack with gap="medium"</Text>
+                        <Text variant="muted">Vertical stack with</Text>
                     </Card>
                     <Card variant="muted" title="Stack Item 2">
                         <Text variant="muted">Items stack vertically by default</Text>
                     </Card>
-                    <Stack direction="row" gap="medium">
+                    <Stack direction="row">
                         <Card variant="muted" title="Row Item 1">
                             <Text variant="muted">Horizontal stack</Text>
                         </Card>

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

@@ -52,7 +52,7 @@ export default function HomePage() {
       }
       subtitle={`${componentsInTab.length} components`}
     >
-      <Grid cols="auto-fit" minColWidth="240px" gap="medium">
+      <Grid cols="auto-fit" minColWidth="240px">
         {componentsInTab.map((config) => {
           const isFullPageComponent = config.cssFamily === 'layout';
           return (

package/templates/app-demo/src/pages/components/ComponentRenderer.tsx.example

@@ -348,7 +348,7 @@ export function ComponentRenderer({
     
     return (
       <Stack gap="large" align="center" justify="center">
-        <Stack gap="medium" className="dndev-w-full dndev-max-w-md">
+        <Stack className="dndev-w-full dndev-max-w-md">
           <Stack direction="row" gap="tight" align="end">
             <Input
               placeholder="Enter toast message..."
@@ -432,8 +432,8 @@ export function ComponentRenderer({
   try {
     if (config.id === 'tabs') {
       return (
-        <Stack gap="medium" align="stretch">
-          <Stack direction="row" gap="medium" align="center">
+        <Stack align="stretch">
+          <Stack direction="row" align="center">
             <Input
               type="number"
               min={1}
@@ -453,7 +453,7 @@ export function ComponentRenderer({
       const isActive = activeOverlayVariant === currentVariant;
       return (
         <>
-          <Stack gap="medium" align="center" justify="center" style={{ minHeight: '200px', position: 'relative', zIndex: 10000 }}>
+          <Stack align="center" justify="center" style={{ minHeight: '200px', position: 'relative', zIndex: 10000 }}>
             <Button
               variant="ghost"
               onClick={() => {
@@ -489,7 +489,7 @@ export function ComponentRenderer({
       }
       
       return (
-        <Stack direction="row" align="center" gap="medium">
+        <Stack direction="row" align="center">
           <Component {...componentProps} />
           <Text variant="muted">State: {stateLabel}</Text>
         </Stack>

package/templates/app-demo/src/pages/components/DemoLayout.tsx.example

@@ -102,7 +102,7 @@ export function DemoLayout({
         />
       </Stack>
 
-      <Stack gap="medium">
+      <Stack>
         <Button
           variant="primary"
           fullWidth
@@ -173,7 +173,7 @@ export function DemoLayout({
               borderBottom: 'var(--border-hairline) solid var(--border)',
             }}
           >
-            <Stack direction="row" gap="medium" align="center" justify="start">
+            <Stack direction="row" align="center" justify="start">
               <Button
                 variant="ghost"
                 icon={ArrowLeft}
@@ -222,7 +222,7 @@ export function DemoLayout({
             </Stack>
 
             {/* Right side: Theme Toggle + Mobile Menu */}
-            <Stack direction="row" gap="medium" justify="end" align="center">
+            <Stack direction="row" justify="end" align="center">
               <ThemeToggle />
               {!isLaptop && (
                 <Sheet

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

@@ -52,8 +52,10 @@ NEXT_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
+# Run `dndev firebase:setup` 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.
 NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
 NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=
 NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=

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

@@ -68,7 +68,7 @@ export default function HomePage() {
         <RadioGroup
           value={currentPreset || 'landing'}
           onValueChange={(value) => setLayoutPreset(value as LayoutPreset)}
-          gridCols={3}
+          gridCols={[1,1,3,3]}
           items={LAYOUT_PRESETS.map((preset) => ({
             value: preset,
             label: preset.charAt(0).toUpperCase() + preset.slice(1),
@@ -84,7 +84,7 @@ export default function HomePage() {
             Stack creates flex containers. Default vertical, use direction="row"
             for horizontal.
           </Text>
-          <Stack direction="row" gap="medium">
+          <Stack direction="row">
             <Card variant="primary" title="Item 1">
               <Text>Horizontal</Text>
             </Card>

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

@@ -37,8 +37,10 @@ VITE_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # Firebase Configuration
 # =============================================================================
 # Get these values from your Firebase project settings
+# Run `dndev firebase:setup` 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.
 VITE_FIREBASE_AUTH_DOMAIN=
 VITE_FIREBASE_STORAGE_BUCKET=
 VITE_FIREBASE_MESSAGING_SENDER_ID=

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

@@ -1,7 +1,8 @@
 /**
- * @fileoverview Home Page
+ * @fileoverview Home Page — Setup Guide
  *
- * THIS FILE IS YOUR STARTING POINT. Modify the content below.
+ * This page guides you through setting up your app.
+ * Replace it with your actual landing page once setup is complete.
  *
  * HOW PAGES WORK:
  * 1. Name files *Page.tsx in src/pages/ → auto-discovered as routes
@@ -12,97 +13,186 @@
 
 import { Home } from 'lucide-react';
 
-import { Button, HeroSection, Section, Card, Grid, Stack } from '@donotdev/components';
+import { HeroSection, Section, Card, Grid, List, Alert, Text, Stack } from '@donotdev/components';
 import type { PageMeta } from '@donotdev/core';
-import { PageContainer, Link } from '@donotdev/ui';
-
-// ============================================================================
-// PAGE METADATA - Controls routing, navigation, and access
-// ============================================================================
-//
-// namespace    → i18n namespace for translations (matches locales/home_en.json)
-// icon         → Navigation icon (from lucide-react)
-// nav          → Show in navigation (default: true, set false to hide)
-// navGroup     → Navigation group: 'main' | 'admin' | 'footer' (default: 'main')
-// route        → Custom route path (default: derived from filename)
-// auth         → Access control:
-//                - undefined → public (anyone can view)
-//                - true → requires login
-//                - 'admin' → requires admin role
-//                - { required: true, role: 'admin' } → full syntax
-// tier         → Subscription tier required: 'pro' | 'enterprise'
-// hideFromMenu → Show in routing but hide from navigation menu
-//
+import { PageContainer } from '@donotdev/ui';
+
 export const NAMESPACE = 'home';
 
 export const meta: PageMeta = {
   namespace: NAMESPACE,
   icon: <Home />,
-  // nav: true,                    // Uncomment to hide from navigation
-  // navGroup: 'main',             // 'main' | 'admin' | 'footer'
-  // route: '/',                   // Custom route (default: / for HomePage)
-  // auth: true,                   // Uncomment to require login
-  // auth: 'admin',                // Uncomment to require admin role
-  // auth: { required: true, role: 'admin' }, // Full syntax
-  // tier: 'pro',                  // Uncomment to require subscription
-  // hideFromMenu: true,           // Uncomment to hide from menu but keep route
 };
 
-// ============================================================================
-// PAGE COMPONENT
-// ============================================================================
-
 export default function HomePage() {
   return (
     <PageContainer>
-      {/* Hero Section - Full-width banner with title and subtitle */}
       <HeroSection
-        title="Welcome to Your App"
-        subtitle="Built with DoNotDev Framework. Edit this page in src/pages/HomePage.tsx"
+        title="Your App is Running"
+        subtitle="Follow the steps below to complete your setup. Replace this page when you're ready to build."
         variant="primary"
       />
 
-      {/* Section - Content block with optional title */}
-      <Section title="Getting Started">
-        <Grid cols={[1, 1, 2, 3]} gap="medium">
-          <Card title="1. Configure" content="Edit src/config/app.ts to set your app name and preset." />
-          <Card title="2. Create Pages" content="Add *Page.tsx files in src/pages/ - they auto-route." />
-          <Card title="3. Add Content" content="Use components from @donotdev/components." />
+      {/* ================================================================ */}
+      {/* REQUIRED SETUP                                                   */}
+      {/* ================================================================ */}
+
+      <Section title="Required Setup">
+        <Grid cols={[1, 1, 2, 2]}>
+          <Card
+            title="1. Git Repository"
+            content={[
+              'git init',
+              'git add . && git commit -m "Initial scaffold"',
+              'Create a repo on GitHub, then:',
+              'git remote add origin <your-repo-url>',
+              'git push -u origin main',
+            ]}
+          />
+
+          <Card
+            title="2. Firebase Setup"
+            content={[
+              'Run: dndev firebase:setup',
+              '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',
+            ]}
+          />
         </Grid>
       </Section>
 
-      {/* Stack - Flexible container for buttons, inline items */}
-      <Section title="Layout Components">
-        <Stack direction="row" gap="medium" wrap>
-          <Button variant="primary">Primary Button</Button>
-          <Button variant="outline">Outline Button</Button>
-          <Button variant="ghost">Ghost Button</Button>
-        </Stack>
+      {/* ================================================================ */}
+      {/* VERIFY SETUP                                                     */}
+      {/* ================================================================ */}
+
+      <Section title="Verify It Works">
+        <Grid cols={[1, 1, 2, 3]}>
+          <Card
+            title="Local Dev"
+            content={[
+              'bun dev → starts the app',
+              'Should load without errors',
+            ]}
+          />
+          <Card
+            title="Emulators"
+            content={[
+              'dndev emu start → Firebase emulators',
+              'Select: Auth + Firestore + Functions',
+              'Test auth and CRUD locally',
+            ]}
+          />
+          <Card
+            title="Deploy"
+            content={[
+              'dndev deploy → deploys to Firebase Hosting',
+              'Functions + hosting deployed automatically',
+              'Cloud Run IAM configured for you',
+            ]}
+          />
+        </Grid>
       </Section>
 
-      {/* Call to Action */}
-      <Section tone="muted" align="center">
-        <Stack gap="medium" align="center">
-          <h2>Ready to Build?</h2>
-          <p>Check out the guides folder for setup instructions.</p>
-          <Stack direction="row" gap="medium">
-            <Button
-              variant="primary"
-              render={({ children, ...props }) => (
-                <Link path="https://donotdev.com" {...props}>{children}</Link>
-              )}
-            >
-              Documentation
-            </Button>
-            <Button
-              variant="outline"
-              render={({ children, ...props }) => (
-                <Link path="https://discord.gg/donotdev" {...props}>{children}</Link>
-              )}
-            >
-              Join Discord
-            </Button>
-          </Stack>
+      {/* ================================================================ */}
+      {/* OPTIONAL SETUP                                                   */}
+      {/* ================================================================ */}
+
+      <Section title="Optional Setup">
+        <Alert
+          variant="info"
+          title="None of these are required to start building"
+          description="Set these up when you need them, not before."
+        />
+
+        <Grid cols={[1, 1, 2, 2]}>
+          <Card
+            title="GitHub Actions (CI/CD)"
+            subtitle="Automatic deploy on push to main"
+            content={[
+              'WAI-WAY Phase 4 generates .github/workflows/ci.yml',
+              'Add secrets in GitHub → Settings → Secrets:',
+              'FIREBASE_SERVICE_ACCOUNT (paste service account JSON)',
+              'Pushes to main auto-deploy after tests pass',
+            ]}
+          />
+
+          <Card
+            title="Staging Environment"
+            subtitle="Separate Firebase project for testing"
+            content={[
+              'Create a second Firebase project (e.g. my-app-staging)',
+              'Add to .firebaserc: { "projects": { "staging": "my-app-staging" } }',
+              'Create .env.staging with staging Firebase config',
+              'Create service-account-key.staging.json',
+              'Deploy with: dndev staging',
+            ]}
+          />
+
+          <Card
+            title="Secrets (Stripe, OAuth, etc.)"
+            subtitle="Server-side API keys for Cloud Functions"
+            content={[
+              'Add secrets to functions/.env (not the app .env)',
+              'Run: dndev sync-secrets to push to Firebase Secret Manager',
+              'Secrets are auto-loaded by Cloud Functions at runtime',
+              'Never put server secrets in VITE_ variables',
+            ]}
+          />
+
+          <Card
+            title="Stripe (Payments)"
+            subtitle="Subscriptions, one-time payments, customer portal"
+            content={[
+              'Go to dashboard.stripe.com → create account',
+              'Get API keys from Developers → API Keys',
+              'Add to functions/.env: STRIPE_SECRET_KEY=sk_test_...',
+              'Add to .env: VITE_STRIPE_PUBLISHABLE_KEY=pk_test_...',
+              'Set up webhook: Developers → Webhooks → Add endpoint',
+              'Webhook URL: https://<your-functions-url>/stripeWebhook',
+              'Run: dndev sync-secrets to push secret key to Firebase',
+            ]}
+          />
+
+          <Card
+            title="Custom Domain"
+            subtitle="Use your own domain instead of .web.app"
+            content={[
+              'Firebase Console → Hosting → Add custom domain',
+              'Add DNS records as instructed',
+              'SSL certificate provisioned automatically',
+            ]}
+          />
+        </Grid>
+      </Section>
+
+      {/* ================================================================ */}
+      {/* NEXT STEPS                                                       */}
+      {/* ================================================================ */}
+
+      <Section title="Start Building" tone="muted" align="center">
+        <Stack align="center" gap="medium">
+          <Text level="body">
+            Once setup is complete, use WAI-WAY to build your app:
+          </Text>
+          <List
+            items={[
+              'Phase 0: Brainstorm — describe your app, produce a spec',
+              'Phase 1: Scaffold — create all pages and routes',
+              'Phase 2: Entities — define your data models',
+              'Phase 3: Compose — build pages with framework components',
+              'Phase 4: Configure — generate tests, firestore rules, CI/CD',
+            ]}
+            ordered
+          />
+          <Text level="small">
+            Read guides/wai-way/WAI_WAY_CLI.md for the full workflow, or use the MCP tools if your IDE supports them.
+          </Text>
         </Stack>
       </Section>
     </PageContainer>

package/templates/functions-firebase/build.mjs.example

@@ -6,12 +6,12 @@
 
 import { build } from 'esbuild';
 import { writeFileSync } from 'fs';
-import { createAppFunctionsConfig, generateFunctionsYamlWithInfo } from '@donotdev/core/functions';
+import { createAppFunctionsConfig, generateFunctionsYamlWithInfo, filterEnvSecrets } from '@donotdev/core/functions';
 import { functionsConfig } from './functions.config.js';
 
 async function buildFunctions() {
   console.log('🔨 Building {{APP_NAME}} functions...');
-  
+
   try {
     const config = createAppFunctionsConfig({
       entry: 'src/index.ts',
@@ -21,26 +21,42 @@ async function buildFunctions() {
     });
 
     console.log('📦 Bundling @donotdev/types and importing framework functions...');
-    
+
     const result = await build(config);
-    
+
     if (result.errors.length > 0) {
       console.error('❌ Build errors:', result.errors);
       process.exit(1);
     }
-    
+
     if (result.warnings.length > 0) {
       console.warn('⚠️ Build warnings:', result.warnings);
     }
-    
+
     console.log('✅ {{APP_NAME}} functions built successfully!');
     console.log('📁 Output directory: lib/');
 
-    // Generate functions.yaml from config
-    const { yaml, staticFunctions, crudFunctions } = generateFunctionsYamlWithInfo(functionsConfig);
+    // Generate functions.yaml from config + auto-detection
+    // Auto-detects: exported functions from src/index.ts + secrets from .env
+    const { yaml, staticFunctions, crudFunctions, autoDetected, autoSecrets } = generateFunctionsYamlWithInfo(
+      functionsConfig,
+      { entryFile: 'src/index.ts', envPath: '.env' }
+    );
     writeFileSync('functions.yaml', yaml);
     console.log(`📄 Generated functions.yaml: ${staticFunctions.length} static + ${crudFunctions.length} CRUD functions`);
-    
+    if (autoDetected.length > 0) {
+      console.log(`🔍 Auto-detected ${autoDetected.length} function(s) from src/index.ts: ${autoDetected.join(', ')}`);
+    }
+    if (autoSecrets.length > 0) {
+      console.log(`🔑 Auto-detected ${autoSecrets.length} secret(s) from .env: ${autoSecrets.join(', ')}`);
+    }
+
+    // Filter .env: move secret keys to .env.local (emulator-only, never deployed)
+    const { stripped } = filterEnvSecrets(functionsConfig);
+    if (stripped.length > 0) {
+      console.log(`🔒 Filtered ${stripped.length} secret(s) from .env → .env.local`);
+    }
+
     // Log bundle info if metafile is available
     if (result.metafile) {
       const { analyzeMetafile } = await import('esbuild');
@@ -48,7 +64,7 @@ async function buildFunctions() {
       console.log('\n📊 Bundle analysis:');
       console.log(analysis);
     }
-    
+
   } catch (error) {
     console.error('❌ Build failed:', error);
     process.exit(1);

package/templates/functions-firebase/functions-firebase/build.mjs.example

@@ -6,12 +6,12 @@
 
 import { build } from 'esbuild';
 import { writeFileSync } from 'fs';
-import { createAppFunctionsConfig, generateFunctionsYamlWithInfo } from '@donotdev/core/functions';
+import { createAppFunctionsConfig, generateFunctionsYamlWithInfo, filterEnvSecrets } from '@donotdev/core/functions';
 import { functionsConfig } from './functions.config.js';
 
 async function buildFunctions() {
   console.log('🔨 Building {{APP_NAME}} functions...');
-  
+
   try {
     const config = createAppFunctionsConfig({
       entry: 'src/index.ts',
@@ -21,26 +21,42 @@ async function buildFunctions() {
     });
 
     console.log('📦 Bundling @donotdev/types and importing framework functions...');
-    
+
     const result = await build(config);
-    
+
     if (result.errors.length > 0) {
       console.error('❌ Build errors:', result.errors);
       process.exit(1);
     }
-    
+
     if (result.warnings.length > 0) {
       console.warn('⚠️ Build warnings:', result.warnings);
     }
-    
+
     console.log('✅ {{APP_NAME}} functions built successfully!');
     console.log('📁 Output directory: lib/');
 
-    // Generate functions.yaml from config
-    const { yaml, staticFunctions, crudFunctions } = generateFunctionsYamlWithInfo(functionsConfig);
+    // Generate functions.yaml from config + auto-detection
+    // Auto-detects: exported functions from src/index.ts + secrets from .env
+    const { yaml, staticFunctions, crudFunctions, autoDetected, autoSecrets } = generateFunctionsYamlWithInfo(
+      functionsConfig,
+      { entryFile: 'src/index.ts', envPath: '.env' }
+    );
     writeFileSync('functions.yaml', yaml);
     console.log(`📄 Generated functions.yaml: ${staticFunctions.length} static + ${crudFunctions.length} CRUD functions`);
-    
+    if (autoDetected.length > 0) {
+      console.log(`🔍 Auto-detected ${autoDetected.length} function(s) from src/index.ts: ${autoDetected.join(', ')}`);
+    }
+    if (autoSecrets.length > 0) {
+      console.log(`🔑 Auto-detected ${autoSecrets.length} secret(s) from .env: ${autoSecrets.join(', ')}`);
+    }
+
+    // Filter .env: move secret keys to .env.local (emulator-only, never deployed)
+    const { stripped } = filterEnvSecrets(functionsConfig);
+    if (stripped.length > 0) {
+      console.log(`🔒 Filtered ${stripped.length} secret(s) from .env → .env.local`);
+    }
+
     // Log bundle info if metafile is available
     if (result.metafile) {
       const { analyzeMetafile } = await import('esbuild');
@@ -48,7 +64,7 @@ async function buildFunctions() {
       console.log('\n📊 Bundle analysis:');
       console.log(analysis);
     }
-    
+
   } catch (error) {
     console.error('❌ Build failed:', error);
     process.exit(1);

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

@@ -4,12 +4,12 @@
  * @fileoverview {{APP_NAME}} Functions Configuration
  * @description Configuration for Firebase Functions deployment
  * @type {import('@donotdev/types').FunctionsConfig}
- * 
- * This config file is used to auto-generate functions.yaml during build.
- * 
- * - Static functions: List your custom functions here
- * - CRUD functions: List entity names to auto-generate CRUD endpoints
- *   (e.g., ['car', 'customer'] generates: create_car, get_car, list_car, update_car, delete_car, etc.)
+ *
+ * Static functions are AUTO-DETECTED from src/index.ts exports.
+ * Secrets are AUTO-DETECTED from .env (non-config keys).
+ * You only need to list CRUD entities and set defaults.
+ *
+ * Use the `functions` object ONLY for overrides (e.g., HTTP triggers for webhooks).
  */
 
 export const functionsConfig = {
@@ -18,18 +18,14 @@ export const functionsConfig = {
     platform: 'gcfv2',
     labels: { app: '{{APP_NAME}}' },
   },
+  // Static functions are auto-detected from src/index.ts exports.
+  // Only add entries here for overrides:
   functions: {
-    // Add your static (non-CRUD) functions here
-    // Example:
-    // getCustomClaims: { category: 'auth' },
-    // setCustomClaims: { category: 'auth' },
-    // stripeWebhook: { category: 'billing', trigger: 'http' },
+    // stripeWebhook: { trigger: 'http' },  // Override: HTTP trigger instead of callable
   },
   crud: {
-    // List entity names to auto-generate CRUD functions
-    // Each entity will generate: create_*, get_*, list_*, update_*, delete_*
-    // Example:
-    // entities: ['car', 'customer', 'inquiry'],
+    // List entity collection names to auto-generate CRUD functions
+    // Each generates: create_*, get_*, list_*, listCard_*, update_*, delete_*
     entities: [],
   },
 };