@donotdev/cli 0.0.3

package/templates/app-vite/src/pages/legal/PrivacyPage.tsx.example

@@ -0,0 +1,69 @@
+/**
+ * @fileoverview Privacy Policy Page
+ * @description Privacy policy page using the reusable template
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { Shield } from 'lucide-react';
+
+import { type PageMeta } from '@donotdev/core';
+import { PrivacyPolicyTemplate } from '@donotdev/templates';
+import { PageContainer } from '@donotdev/ui';
+
+import { legalConfig } from '../../config/legal';
+
+/**
+ * Privacy page translation namespace
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const NAMESPACE = 'privacy';
+
+/**
+ * Privacy page metadata configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const meta: PageMeta = {
+  namespace: NAMESPACE,
+  icon: <Shield />,
+  hideFromMenu: true,
+};
+
+/**
+ * Privacy Policy Page Component
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ *
+ * Uses the reusable PrivacyPolicyTemplate with centralized legal config
+ */
+function PrivacyPage() {
+  return (
+    <PageContainer>
+      <PrivacyPolicyTemplate
+        companyName={legalConfig.company.name}
+        websiteUrl={legalConfig.website.url}
+        privacyEmail={legalConfig.contact.privacyEmail}
+        companyAddress={legalConfig.contact.address}
+        dpoEmail={legalConfig.contact.dpoEmail}
+        sections={legalConfig.sections.privacy}
+        contactInfo={{
+          supportEmail: legalConfig.contact.supportEmail,
+        }}
+        lastUpdated={legalConfig.lastUpdated?.privacy}
+      />
+    </PageContainer>
+  );
+}
+
+export default PrivacyPage;
+

package/templates/app-vite/src/pages/legal/TermsPage.tsx.example

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Terms of Service Page
+ * @description Terms of service page using the reusable template
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { FileText } from 'lucide-react';
+
+import { type PageMeta } from '@donotdev/core';
+import { TermsOfServiceTemplate } from '@donotdev/templates';
+import { PageContainer } from '@donotdev/ui';
+
+import { legalConfig } from '../../config/legal';
+
+/**
+ * Terms page translation namespace
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const NAMESPACE = 'terms';
+
+/**
+ * Terms page metadata configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const meta: PageMeta = {
+  namespace: NAMESPACE,
+  icon: <FileText />,
+  hideFromMenu: true,
+};
+
+/**
+ * Terms of Service Page Component
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ *
+ * Uses the reusable TermsOfServiceTemplate with centralized legal config
+ */
+function TermsPage() {
+  return (
+    <PageContainer>
+      <TermsOfServiceTemplate
+        companyName={legalConfig.company.name}
+        websiteUrl={legalConfig.website.url}
+        legalEmail={legalConfig.contact.email}
+        companyAddress={legalConfig.contact.address}
+        jurisdiction={legalConfig.jurisdiction.country}
+        arbitrationOrg={legalConfig.jurisdiction.arbitrationOrg}
+        arbitrationLocation={legalConfig.jurisdiction.arbitrationLocation}
+        sections={legalConfig.sections.terms}
+        contactInfo={{
+          supportEmail: legalConfig.contact.supportEmail,
+        }}
+        lastUpdated={legalConfig.lastUpdated?.terms}
+      />
+    </PageContainer>
+  );
+}
+
+export default TermsPage;
+

package/templates/app-vite/src/pages/locales/README.md.example

@@ -0,0 +1 @@
+ 

package/templates/app-vite/src/pages/locales/example_en.json.example

@@ -0,0 +1,5 @@
+{
+  "title": "Example Page",
+  "description": "Example page locale file that is dynamically loaded on demand only"
+}
+

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

@@ -0,0 +1,179 @@
+/* src/themes.css */
+
+/* ===========================
+   APP-WIDE SETTINGS
+   These apply to all themes - spacing, radius, shadows, routing animations
+   =========================== */
+:root {
+  /* ===========================
+     ROUTING ANIMATIONS
+     Customize page transition animations
+     Pure CSS - zero JS overhead. Respects prefers-reduced-motion.
+     Override in themes.css: --routing-animation: slide; to change animation type
+     =========================== */
+  /* Single animation type (fade, slide, or none to disable) - app-wide */
+  /* --routing-animation: fade; */  /* fade | slide | none */
+  /* --routing-default-duration: var(--dur-normal); */  /* Animation duration */
+
+  /* Breakpoint-specific durations (all inherit from --routing-default-duration) */
+  /* --routing-mobile-duration: var(--routing-default-duration); */
+  /* --routing-tablet-duration: var(--routing-default-duration); */
+  /* --routing-desktop-duration: var(--routing-default-duration); */
+  /* --routing-wide-duration: var(--routing-default-duration); */
+  
+  /* Examples: */
+  /* --routing-animation: slide; */  /* Use slide animation */
+  /* --routing-animation: none; */  /* Disable animations */
+  /* --routing-default-duration: 200ms; */  /* Faster animations */
+
+  /* ===========================
+     SPACING OVERRIDES
+     Customize spacing scale
+     =========================== */
+  /* --gap-sm: 0.5rem; */        /* 8px - tight spacing */
+  /* --gap-md: 1rem; */          /* 16px - medium spacing (default) */
+  /* --gap-lg: 2rem; */          /* 32px - large spacing */
+
+  /* ===========================
+     BORDER RADIUS OVERRIDES
+     Customize component corners
+     =========================== */
+  /* --radius-interactive: var(--radius-none); */ /* Buttons, links (default: square) */
+  /* --radius-surface: var(--radius-md); */ /* Cards, dialogs (default: 8px round) */
+  /* --radius-floating: var(--radius-none); */ /* Dropdowns, popovers (default: square) */
+
+  /* ===========================
+     SHADOW OVERRIDES
+     Customize elevation
+     =========================== */
+  /* --shadow-sm: ...; */        /* Small shadows */
+  /* --shadow-md: ...; */        /* Medium shadows (default) */
+  /* --shadow-xl: ...; */        /* Large shadows */
+}
+
+/* ===========================
+   LIGHT THEME (High Contrast Light)
+   Background: White
+   Foreground: Black
+   =========================== */
+:root.light {
+  --theme-icon: 'Sun';
+  --theme-label: 'Light';
+  --theme-is-dark: 0;
+
+  /* ===========================
+     1. USER SETS - 5 BRAND COLORS
+     =========================== */
+  --foreground: #000000;
+  --background: #ffffff;
+  --primary: #00bcd4; /* Cyan */
+  --secondary: #047857; /* Emerald-700 - WCAG AA compliant (5.48:1 with white) */
+  --accent: #ff9800; /* Orange */
+
+  /* ===========================
+     2. FRAMEWORK DEFAULTS - STATUS COLORS
+     (Override if needed)
+     =========================== */
+  --success: #047857; /* Emerald-700 - WCAG AA compliant (5.48:1 with white) */
+  --warning: #f59e0b;
+  --destructive: #dc2626;
+
+  /* ===========================
+     3. AUTO-COMPUTED - SURFACES
+     (Plain sight computation for easy overriding)
+     =========================== */
+  --muted: color-mix(in oklab, var(--foreground) 5%, var(--background));
+  --muted-foreground: color-mix(in oklab, var(--foreground) 75%, transparent);
+  --border: color-mix(in oklab, var(--foreground) 15%, var(--background));
+  --input: var(--muted);
+  --ring: var(--primary);
+
+      --card: var(--background);
+  --card-foreground: var(--foreground);
+  --popover: var(--card);
+  --popover-foreground: var(--card-foreground);
+  --surface-1: var(--card);
+
+  /* ===========================
+     4. AUTO-COMPUTED - TEXT ON BRAND COLORS
+     (Mapped to foreground/background for consistency)
+     =========================== */
+  --primary-foreground: var(--foreground);
+  --secondary-foreground: var(--background);
+  --accent-foreground: var(--foreground);
+  
+  --success-foreground: var(--background);
+  --warning-foreground: var(--foreground);
+  --destructive-foreground: var(--background);
+}
+
+/* ===========================
+   DARK THEME (High Contrast Dark)
+   Background: Black
+   Foreground: White
+   =========================== */
+:root.dark {
+  --theme-icon: 'Moon';
+  --theme-label: 'Dark';
+  --theme-is-dark: 1;
+
+  /* ===========================
+     1. USER SETS - 5 BRAND COLORS
+     =========================== */
+  --foreground: #ffffff;
+  --background: #000000;
+  --primary: #00bcd4; /* Cyan */
+  --secondary: #047857; /* Emerald-700 - WCAG AA compliant (5.48:1 with white) */
+  --accent: #ff9800; /* Orange */
+
+  /* ===========================
+     2. FRAMEWORK DEFAULTS - STATUS COLORS
+     =========================== */
+  --success: #047857; /* Emerald-700 - WCAG AA compliant (5.48:1 with white) */
+  --warning: #f59e0b;
+  --destructive: #dc2626; /* Red-600 - WCAG AA compliant (4.83:1 with white) */
+
+  /* ===========================
+     3. AUTO-COMPUTED - SURFACES
+     =========================== */
+  --muted: color-mix(in oklab, var(--foreground) 10%, var(--background));
+  --muted-foreground: color-mix(in oklab, var(--foreground) 75%, transparent);
+  --border: color-mix(in oklab, var(--foreground) 15%, var(--background));
+  --input: var(--muted);
+  --ring: var(--primary);
+
+      --card: var(--background);
+  --card-foreground: var(--foreground);
+  --popover: var(--card);
+  --popover-foreground: var(--card-foreground);
+  --surface-1: var(--card);
+
+  /* ===========================
+     4. AUTO-COMPUTED - TEXT ON BRAND COLORS
+     =========================== */
+  --primary-foreground: var(--background);
+  --secondary-foreground: var(--foreground);
+  --accent-foreground: var(--background);
+
+  --success-foreground: var(--foreground);
+  --warning-foreground: var(--background);
+  --destructive-foreground: var(--foreground);
+}
+
+/* ===========================
+   CUSTOM THEMES
+   =========================== */
+
+/* Add your custom themes here */
+/* Example:
+.brand {
+  --theme-icon: 'Zap';
+  --theme-label: 'Brand';
+  --background: #your-brand-background;
+  --foreground: #your-brand-foreground;
+  --primary: #your-brand-primary;
+  --secondary: #your-brand-secondary;
+  --accent: #your-brand-accent;
+  ... other variables ...
+}
+*/

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

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "types": ["node", "vite/client"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

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

@@ -0,0 +1,9 @@
+import { defineViteConfig } from '@donotdev/core/vite';
+import { appConfig } from './src/config/app';
+
+export default defineViteConfig({
+  appConfig,
+  server: {
+    https: false,
+  },
+});

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

@@ -0,0 +1,129 @@
+# {{APP_NAME}} Functions
+
+This directory contains the Firebase Functions for the {{APP_NAME}} app, generated using the DoNotDev framework's scaffolding system.
+
+## Structure
+
+```
+functions/
+├── src/
+│   ├── auth/                    # Authentication functions
+│   ├── oauth/                   # OAuth functions
+│   ├── billing/                 # Billing functions
+│   └── index.ts                # Main functions entry point
+├── package.json                # Dependencies and scripts
+├── tsconfig.json              # TypeScript configuration
+├── functions.yaml             # Firebase function manifest (manually maintained - must match functions exported from src/index.ts)
+├── .env.example               # Environment variables template
+├── service-account-key.json   # Firebase service account key (copy from Firebase Console)
+└── README.md                  # This file
+```
+
+## Features
+
+- **Authentication Management**: User custom claims and auth status
+- **OAuth Integration**: GitHub access management
+- **Billing Processing**: Stripe checkout and webhook handling
+- **Secure API Layer**: Professional frontend-backend communication
+- **Error Handling**: Comprehensive error handling and logging
+
+## Environment Variables
+
+### File Structure
+
+**Functions use a different .env system than Vite/Next.js:**
+- `.env` → Local development only (not automatically loaded, use with dotenv if needed)
+- Production → Use Firebase Functions Secrets (synced automatically during `dndev deploy`)
+
+**Note:** Functions don't follow Vite/Next.js `.env.local` priority rules. Use Firebase Secrets for production.
+
+### Required Environment Variables
+
+```bash
+# Stripe Configuration
+STRIPE_SECRET_KEY=sk_live_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+
+# GitHub Configuration
+GITHUB_PERSONAL_ACCESS_TOKEN=ghp_...
+GITHUB_REPO_OWNER=your-org
+GITHUB_REPO_NAME=your-repo
+
+# Firebase Configuration
+FIREBASE_PROJECT_ID=your-project-id
+FIREBASE_REGION=us-central1
+```
+
+### Setup Instructions
+
+1. **Stripe Setup**:
+   - Create products in Stripe Dashboard
+   - Get price IDs and add to frontend `.env.local` (dev) or `.env.production.local` (prod)
+   - Configure webhook endpoint in Stripe
+   - Add webhook secret to functions `.env` (local) or Firebase Secrets (production)
+
+2. **GitHub Setup**:
+   - Create Personal Access Token with `repo` scope
+   - Add token to functions `.env` (local) or Firebase Secrets (production)
+   - Configure repository owner/name
+
+3. **Firebase Setup**:
+   - Get service account key: Firebase Console → Project Settings → Service Accounts → "Generate new private key"
+   - Copy JSON content into `service-account-key.json` in app root (shared by frontend + functions)
+   - Deploy: `dndev deploy` (from workspace root)
+   - Update webhook URL in Stripe dashboard
+
+## Deployment
+
+Use the unified deployment command from workspace root:
+
+```bash
+# Deploy everything (interactive)
+dndev deploy
+
+# Deploy specific app
+dndev deploy <app-name>
+```
+
+**Important:** `functions.yaml` must be manually maintained. Each function exported from `src/index.ts` must have a corresponding entry in `functions.yaml`. The deployment script preserves `functions.yaml` and does not modify it.
+
+See [FUNCTIONS.md](../../guides/FUNCTIONS.md) for detailed information about `functions.yaml` and function deployment.
+
+## Development
+
+```bash
+# Start Firebase emulators
+bun run serve
+
+# Start with debugging
+bun run dev
+```
+
+## API Endpoints
+
+### Stripe Webhook
+
+- **URL**: `https://your-project.cloudfunctions.net/stripeWebhook`
+- **Events**: `checkout.session.completed`
+- **Purpose**: Processes purchases and grants access
+
+### Checkout Session
+
+- **Integration**: Direct Stripe calls (no function needed)
+- **Purpose**: Creates Stripe checkout sessions for purchases
+
+## Security
+
+- All functions require authentication
+- Webhook signature verification
+- Secure GitHub token management
+- Firebase custom claims for user status
+
+## Framework Integration
+
+This functions package demonstrates how to:
+
+- Use the framework's scaffolding system
+- Implement secure API communication
+- Handle complex purchase flows
+- Integrate with external services (Stripe, GitHub)

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

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Build script for {{APP_NAME}} functions
+ * @description Bundles @donotdev/types and imports framework functions
+ */
+
+import { build } from 'esbuild';
+import { createAppFunctionsConfig } from '@donotdev/core/functions';
+
+async function buildFunctions() {
+  console.log('🔨 Building {{APP_NAME}} functions...');
+  
+  try {
+    const config = createAppFunctionsConfig({
+      entry: 'src/index.ts',
+      outDir: 'lib',
+      minify: process.env.NODE_ENV === 'production',
+      sourcemap: true,
+    });
+
+    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/');
+    
+    // Log bundle info if metafile is available
+    if (result.metafile) {
+      const { analyzeMetafile } = await import('esbuild');
+      const analysis = await analyzeMetafile(result.metafile);
+      console.log('\n📊 Bundle analysis:');
+      console.log(analysis);
+    }
+    
+  } catch (error) {
+    console.error('❌ Build failed:', error);
+    process.exit(1);
+  }
+}
+
+// Run the build
+buildFunctions();

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

@@ -0,0 +1,45 @@
+# =============================================================================
+# {{APP_NAME}} Firebase Functions Environment Variables
+# =============================================================================
+# Copy this file to .env in the functions directory and update with your values
+
+# =============================================================================
+# Stripe Configuration
+# =============================================================================
+# Stripe Secret Key (server-side only)
+STRIPE_SECRET_KEY=sk_test_1234567890abcdef
+
+# Stripe Webhook Secret (for webhook signature verification)
+STRIPE_WEBHOOK_SECRET=whsec_1234567890abcdef
+
+# =============================================================================
+# GitHub Configuration
+# =============================================================================
+# GitHub Personal Access Token (for repository access management)
+# Required scopes: repo (full control of private repositories)
+GITHUB_PERSONAL_ACCESS_TOKEN=ghp_1234567890abcdef
+
+# GitHub Repository Configuration
+GITHUB_REPO_OWNER=your-org
+GITHUB_REPO_NAME=your-repo
+
+# =============================================================================
+# Firebase Configuration
+# =============================================================================
+# Firebase Project ID (usually auto-detected from Firebase Admin SDK)
+FIREBASE_PROJECT_ID=your-project-id
+
+# Firebase Region (default: us-central1)
+FIREBASE_REGION=us-central1
+
+# =============================================================================
+# Development Configuration
+# =============================================================================
+# Node Environment
+NODE_ENV=development
+
+# =============================================================================
+# Setup Instructions
+# =============================================================================
+# 1. Get Stripe keys from: https://dashboard.stripe.com/apikeys
+# 2. Get GitHub token from: https://github.com/settings/tokens