@donotdev/cli 0.0.14 → 0.0.16

package/templates/app-expo/metro.config.js.example

@@ -0,0 +1,20 @@
+// Learn more https://docs.expo.dev/guides/customizing-metro
+const { getDefaultConfig } = require('expo/metro-config');
+const path = require('path');
+
+const projectRoot = __dirname;
+const workspaceRoot = path.resolve(projectRoot, '../..');
+
+/** @type {import('expo/metro-config').MetroConfig} */
+const config = getDefaultConfig(projectRoot);
+
+// Watch workspace packages (not the entire root — avoids churning on unrelated changes)
+config.watchFolders = [path.resolve(workspaceRoot, 'packages')];
+
+// Let Metro resolve from both the app's own node_modules and the workspace root
+config.resolver.nodeModulesDirs = [
+  path.resolve(projectRoot, 'node_modules'),
+  path.resolve(workspaceRoot, 'node_modules'),
+];
+
+module.exports = config;

package/templates/app-expo/service-account-key.json.example

@@ -0,0 +1,12 @@
+{
+  "type": "service_account",
+  "project_id": "{{YOUR_FIREBASE_PROJECT_ID}}",
+  "private_key_id": "your_private_key_id",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nYour private key here\n-----END PRIVATE KEY-----\n",
+  "client_email": "firebase-adminsdk-xxxxx@{{YOUR_FIREBASE_PROJECT_ID}}.iam.gserviceaccount.com",
+  "client_id": "your_client_id",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-xxxxx%40{{YOUR_FIREBASE_PROJECT_ID}}.iam.gserviceaccount.com"
+}

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-expo/tsconfig.json.example

@@ -0,0 +1,19 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "strict": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    ".expo/types/**/*.ts",
+    "expo-env.d.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

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

@@ -36,7 +36,7 @@ NEXT_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # =============================================================================
 # Comma-separated list of enabled auth providers
 # Available: github (required for framework), google, facebook, discord, twitter, microsoft, spotify, linkedin, reddit, twitch, yahoo, apple
-# Uncomment when Firebase is configured (requires NEXT_PUBLIC_FIREBASE_API_KEY and NEXT_PUBLIC_FIREBASE_PROJECT_ID)
+# Uncomment when your backend is configured
 # NEXT_PUBLIC_AUTH_PARTNERS=google,github
 
 # Comma-separated list of enabled OAuth partners for API access
@@ -49,38 +49,9 @@ NEXT_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # NEXT_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
-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=
-NEXT_PUBLIC_FIREBASE_APP_ID=
-NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=
-NEXT_PUBLIC_FIREBASE_FUNCTIONS_REGION=
-
-# =============================================================================
-# Firebase Emulator (Development only)
-# =============================================================================
-# Set to true to use Firebase emulators instead of production services
-NEXT_PUBLIC_USE_FIREBASE_EMULATOR=false
-NEXT_PUBLIC_FIREBASE_EMULATOR_HOST=localhost
-NEXT_PUBLIC_FIREBASE_EMULATOR_PORT=9099
-NEXT_PUBLIC_FIREBASE_AUTH_EMULATOR_HOST=http://localhost:9099
-NEXT_PUBLIC_FIREBASE_FIRESTORE_EMULATOR_HOST=localhost:8080
-NEXT_PUBLIC_FIREBASE_FUNCTIONS_EMULATOR_PORT=5001
-
-# =============================================================================
-# Firebase App Check (Abuse Protection)
-# =============================================================================
-# reCAPTCHA v3 site key for App Check
-# NEXT_PUBLIC_RECAPTCHA_SITE_KEY=6LcXXXX...
-# Optional: Debug token for localhost testing
-# NEXT_PUBLIC_APPCHECK_DEBUG_TOKEN=XXXX-XXXX-XXXX
 
 # =============================================================================
 # Stripe Configuration (if using billing)
@@ -91,4 +62,4 @@ NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
 # Sentry (optional - auto-enabled if SENTRY_DSN is set)
 # =============================================================================
 # Framework automatically initializes Sentry if this variable is set
-NEXT_PUBLIC_SENTRY_DSN=
+NEXT_PUBLIC_SENTRY_DSN=

package/templates/app-next/src/app/ClientLayout.tsx.example

@@ -2,6 +2,8 @@
 // src/app/ClientLayout.tsx
 
 import { NextJsAppProviders } from '@donotdev/ui/next';
+
+import '../config/providers';
 import { appConfig } from '../config/app';
 
 interface ClientLayoutProps {

package/templates/app-next/src/app/layout.tsx.example

@@ -1,13 +1,13 @@
 import type { Metadata } from 'next';
+
+import { FontPreloadLinks } from '@donotdev/ui/next';
+
 import '../globals.css';
 import { ClientLayout } from './ClientLayout';
 
 /**
- * Framework fonts are loaded via CSS @font-face rules in dndev.css
- *
- * The framework CSS includes optimized @font-face declarations for Inter
- * (default) and Roboto (optional) with proper unicode-range subsetting for performance.
- * Fonts are copied from framework to public/fonts/ by AssetDiscovery during build.
+ * Framework fonts are loaded via CSS @font-face rules in dndev.css (bundled).
+ * Font preload links are injected at build time; FontPreloadLinks reads the manifest for SSR.
  */
 
 export const metadata: Metadata = {
@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 
 /**
  * Root layout for Next.js App Router
- * 
+ *
  * Theme detection happens client-side via ClientLayout to avoid
  * Next.js 16 + Turbopack race condition with async layouts.
  * Brief FOUC possible on first load, but prevents build-manifest.json errors.
@@ -35,6 +35,7 @@ export default function RootLayout({
     >
       <head>
         <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+        <FontPreloadLinks />
       </head>
       <body className="light">
         <ClientLayout>{children}</ClientLayout>

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-next/src/globals.css.example

@@ -4,15 +4,6 @@
 @import './themes.css';
 
 /**
- * Font configuration
- * 
- * Framework defaults to Inter (defined in @donotdev/components/styles/variables.css).
- * Fonts are loaded via CSS @font-face rules in @donotdev/ui/assets/fonts/fonts.css
- * and copied to public/fonts/ by AssetDiscovery during build.
- * 
- * To override, uncomment and customize:
- * :root {
- *   --font-sans: 'YourFont', sans-serif;
- *   --font-family: var(--font-sans);
- * }
+ * Font choices (--font-family, --font-sans, etc.) belong in themes.css.
+ * Fonts (Inter, Space Grotesk, Playfair, Roboto) are bundled via @donotdev/ui; no external fetch, no public/fonts required.
  */ 

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

@@ -103,7 +103,7 @@ export default function HomePage() {
             areas={`"header header"
 "sidebar main"
 "footer footer"`}
-            templateColumns="1fr 2fr"
+            cols="1fr 2fr"
             gap="tight"
           >
             <GridArea name="header">

package/templates/app-next/src/themes.css.example

@@ -1,8 +1,11 @@
+/**
+ * src/themes.css — SSOT for essence and theme variables. Import in globals.css only.
+ * Default = SaaS (Inter). Optional .brutalist and .luxury do not apply until class is set on <html>.
+ */
 /* src/themes.css */
 
 /* ===========================
    APP-WIDE SETTINGS
-   Spacing, radius, shadows, animations - apply to all themes
    =========================== */
 :root {
   /* Routing animations (fade | slide | none) */
@@ -115,17 +118,11 @@
 }
 
 /* ===========================
-   CUSTOM THEMES
-   Add your brand themes below
+   OPTIONAL ESSENCES (do not apply by default; set <html class="brutalist"> or class="luxury" to use)
+   See guides/dndev/essences_reference.css for full .brutalist and .luxury blocks.
    =========================== */
 
-/* Example:
-:root.brand {
-  --theme-icon: 'Zap';
-  --theme-label: 'Brand';
-  --theme-is-dark: 0;
-  --background: #your-color;
-  --foreground: #your-color;
-  ...
-}
-*/
+/* ===========================
+   CUSTOM THEMES
+   =========================== */
+/* Example: .brand { --theme-icon: 'Zap'; --theme-label: 'Brand'; --theme-is-dark: 0; ... } */

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

@@ -21,7 +21,7 @@ VITE_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # =============================================================================
 # Comma-separated list of enabled auth providers
 # Available: github (required for framework), google, facebook, discord, twitter, microsoft, spotify, linkedin, reddit, twitch, yahoo, apple
-# Uncomment when Firebase is configured (requires VITE_FIREBASE_API_KEY and VITE_FIREBASE_PROJECT_ID)
+# Uncomment when your backend is configured
 # VITE_AUTH_PARTNERS=github
 
 # Comma-separated list of enabled OAuth partners for API access
@@ -34,38 +34,9 @@ VITE_DONOTDEV_LICENSE_KEY=dndev_your_key_here
 # VITE_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
-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=
-VITE_FIREBASE_APP_ID=
-VITE_FIREBASE_MEASUREMENT_ID=
-VITE_FIREBASE_FUNCTIONS_REGION=
-
-# =============================================================================
-# Firebase Emulator (Development only)
-# =============================================================================
-# Set to true to use Firebase emulators instead of production services
-VITE_USE_FIREBASE_EMULATOR=false
-VITE_FIREBASE_EMULATOR_HOST=localhost
-VITE_FIREBASE_EMULATOR_PORT=9099
-VITE_FIREBASE_AUTH_EMULATOR_HOST=http://localhost:9099
-VITE_FIREBASE_FIRESTORE_EMULATOR_HOST=localhost:8080
-VITE_FIREBASE_FUNCTIONS_EMULATOR_PORT=5001
-
-# =============================================================================
-# Firebase App Check (Abuse Protection)
-# =============================================================================
-# reCAPTCHA v3 site key for App Check
-# VITE_RECAPTCHA_SITE_KEY=6LcXXXX...
-# Optional: Debug token for localhost testing
-# VITE_APPCHECK_DEBUG_TOKEN=XXXX-XXXX-XXXX
 
 # =============================================================================
 # Stripe Configuration (if using billing)

package/templates/app-vite/index.html.example

@@ -16,13 +16,8 @@
   <!-- ✅ PWA: Manifest link (if exists) -->
   <link rel="manifest" href="/manifest.json" />
   
-  <!-- ✅ PERFORMANCE: Preload critical fonts (non-blocking) -->
-  <link rel="preload" href="/fonts/Inter-latin.woff2" as="font" type="font/woff2" crossorigin="anonymous">
-  <link rel="preload" href="/fonts/Roboto-400-latin.woff2" as="font" type="font/woff2" crossorigin="anonymous">
-  
-  <!-- ✅ PERFORMANCE: Load extended font subsets async (non-blocking) -->
-  <link rel="stylesheet" href="/fonts/fonts.css" media="print" onload="this.media='all'">
-  <noscript><link rel="stylesheet" href="/fonts/fonts.css"></noscript>
+  <!-- Fonts: Inter, Space Grotesk, Playfair, Roboto loaded via @donotdev/ui/dndev.css (bundled). -->
+  <!-- DNDEV_FONT_PRELOADS -->
   
   <!-- ✅ PERFORMANCE: Preconnect to external domains (OAuth providers) -->
   <!-- GitHub OAuth -->
@@ -41,23 +36,6 @@
 
   <!-- ✅ PERFORMANCE: Critical CSS inlined here by build -->
   <style>
-    /* Critical @font-face declarations - must be inline for preloaded fonts to work */
-    @font-face {
-      font-family: Inter;
-      font-style: normal;
-      font-weight: 400 700;
-      font-display: swap;
-      src: url('/fonts/Inter-latin.woff2') format('woff2');
-      unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
-    }
-    @font-face {
-      font-family: Roboto;
-      font-style: normal;
-      font-weight: 400;
-      font-display: swap;
-      src: url('/fonts/Roboto-400-latin.woff2') format('woff2');
-      unicode-range: U+0000-00FF;
-    }
     /* Critical above-the-fold styles */
     html, body {
       margin: 0;

package/templates/app-vite/src/App.tsx.example

@@ -7,6 +7,8 @@
  */
 
 import { ViteAppProviders } from '@donotdev/ui/vite';
+
+import './config/providers';
 import { appConfig } from './config/app';
 
 /**

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/globals.css.example

@@ -4,16 +4,6 @@
 @import './themes.css';
 
 /**
- * Font configuration
- * 
- * Framework defaults to Inter (defined in @donotdev/components/styles/variables.css).
- * Fonts are loaded via CSS @font-face rules in @donotdev/ui/assets/fonts/fonts.css
- * and copied to public/fonts/ by AssetDiscovery during build.
- * 
- * To override, uncomment and customize:
- * :root {
- *   --font-sans: 'YourFont', sans-serif;
- *   --font-mono: 'YourMonoFont', monospace;
- *   --font-family: var(--font-sans);
- * }
+ * Font choices (--font-family, --font-sans, etc.) belong in themes.css.
+ * Fonts (Inter, Space Grotesk, Playfair, Roboto) are bundled via @donotdev/ui; no external fetch, no public/fonts required.
  */ 

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

@@ -54,8 +54,7 @@ export default function ProductPage() {
   const isNew = id === 'new';
 
   // useCrud provides CRUD operations with optimistic updates
-  // backend: 'functions' uses Cloud Functions, 'firestore' uses direct Firestore
-  const { get, add, update, error } = useCrud(productEntity, { backend: 'functions' });
+  const { get, add, update, error } = useCrud(productEntity);
   const [formData, setFormData] = useState<any>(null);
 
   // ==========================================================================

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',
@@ -176,7 +176,7 @@ export default function HomePage() {
       {/* ================================================================ */}
 
       <Section title="Start Building" tone="muted" align="center">
-        <Stack align="center" gap="medium">
+        <Stack align="center">
           <Text level="body">
             Once setup is complete, use WAI-WAY to build your app:
           </Text>