kofi-stack-template-generator 2.0.0

package/dist/index.js

@@ -0,0 +1,744 @@
+// src/core/virtual-fs.ts
+import { createFsFromVolume, Volume } from "memfs";
+import path from "path";
+var VirtualFileSystem = class {
+  volume;
+  fs;
+  binarySourcePaths = /* @__PURE__ */ new Map();
+  constructor() {
+    this.volume = new Volume();
+    this.fs = createFsFromVolume(this.volume);
+  }
+  /**
+   * Write a file to the virtual filesystem
+   */
+  writeFile(filePath, content) {
+    const dir = path.dirname(filePath);
+    this.mkdir(dir);
+    this.fs.writeFileSync(filePath, content);
+  }
+  /**
+   * Read a file from the virtual filesystem
+   */
+  readFile(filePath) {
+    return this.fs.readFileSync(filePath);
+  }
+  /**
+   * Check if a path exists
+   */
+  exists(filePath) {
+    try {
+      this.fs.statSync(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Check if path is a file
+   */
+  fileExists(filePath) {
+    try {
+      return this.fs.statSync(filePath).isFile();
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Check if path is a directory
+   */
+  directoryExists(filePath) {
+    try {
+      return this.fs.statSync(filePath).isDirectory();
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Create directory recursively
+   */
+  mkdir(dirPath) {
+    if (!this.exists(dirPath)) {
+      this.fs.mkdirSync(dirPath, { recursive: true });
+    }
+  }
+  /**
+   * Delete a file
+   */
+  deleteFile(filePath) {
+    if (this.fileExists(filePath)) {
+      this.fs.unlinkSync(filePath);
+    }
+  }
+  /**
+   * List directory contents
+   */
+  listDir(dirPath) {
+    if (!this.directoryExists(dirPath)) {
+      return [];
+    }
+    return this.fs.readdirSync(dirPath);
+  }
+  /**
+   * Track source path for binary files (for later copying)
+   */
+  setBinarySourcePath(virtualPath, sourcePath) {
+    this.binarySourcePaths.set(virtualPath, sourcePath);
+  }
+  /**
+   * Get source path for binary file
+   */
+  getBinarySourcePath(virtualPath) {
+    return this.binarySourcePaths.get(virtualPath);
+  }
+  /**
+   * Convert the virtual filesystem to a tree structure
+   */
+  toTree(config) {
+    const root = this.buildTree("/");
+    const stats = this.countNodes(root);
+    return {
+      root,
+      fileCount: stats.files,
+      directoryCount: stats.directories,
+      config
+    };
+  }
+  buildTree(dirPath) {
+    const name = dirPath === "/" ? "/" : path.basename(dirPath);
+    const children = [];
+    const entries = this.listDir(dirPath);
+    for (const entry of entries) {
+      const fullPath = path.join(dirPath, entry);
+      const stat = this.fs.statSync(fullPath);
+      if (stat.isDirectory()) {
+        children.push(this.buildTree(fullPath));
+      } else {
+        const content = this.fs.readFileSync(fullPath);
+        const file = {
+          type: "file",
+          path: fullPath,
+          name: entry,
+          content,
+          extension: path.extname(entry),
+          sourcePath: this.binarySourcePaths.get(fullPath)
+        };
+        children.push(file);
+      }
+    }
+    return {
+      type: "directory",
+      path: dirPath,
+      name,
+      children
+    };
+  }
+  countNodes(node) {
+    if (node.type === "file") {
+      return { files: 1, directories: 0 };
+    }
+    let files = 0;
+    let directories = 1;
+    for (const child of node.children) {
+      const counts = this.countNodes(child);
+      files += counts.files;
+      directories += counts.directories;
+    }
+    return { files, directories };
+  }
+  /**
+   * Get the raw memfs instance for advanced operations
+   */
+  getRawFs() {
+    return this.fs;
+  }
+};
+
+// src/core/template-processor.ts
+import Handlebars from "handlebars";
+import path2 from "path";
+Handlebars.registerHelper("eq", (a, b) => a === b);
+Handlebars.registerHelper("ne", (a, b) => a !== b);
+Handlebars.registerHelper("and", (...args) => {
+  const values = args.slice(0, -1);
+  return values.every(Boolean);
+});
+Handlebars.registerHelper("or", (...args) => {
+  const values = args.slice(0, -1);
+  return values.some(Boolean);
+});
+Handlebars.registerHelper("includes", (array, value) => {
+  if (!Array.isArray(array)) return false;
+  return array.includes(value);
+});
+Handlebars.registerHelper("not", (value) => !value);
+Handlebars.registerHelper("json", (value) => JSON.stringify(value, null, 2));
+var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".ico",
+  ".webp",
+  ".svg",
+  ".woff",
+  ".woff2",
+  ".ttf",
+  ".eot",
+  ".otf",
+  ".mp3",
+  ".mp4",
+  ".webm",
+  ".pdf",
+  ".zip",
+  ".tar",
+  ".gz"
+]);
+function isBinaryFile(filename) {
+  const ext = path2.extname(filename).toLowerCase();
+  return BINARY_EXTENSIONS.has(ext);
+}
+function processTemplateString(template, config) {
+  try {
+    const compiled = Handlebars.compile(template, { noEscape: true });
+    return compiled(config);
+  } catch (error) {
+    console.error("Template processing error:", error);
+    return template;
+  }
+}
+function transformFilename(filename, config) {
+  let result = filename;
+  if (result.endsWith(".hbs")) {
+    result = result.slice(0, -4);
+  }
+  if (result.startsWith("_")) {
+    result = "." + result.slice(1);
+  }
+  if (result.includes("{{")) {
+    result = processTemplateString(result, config);
+  }
+  return result;
+}
+function shouldIncludeFile(templatePath, config) {
+  if (templatePath.includes("/if-monorepo/") && config.structure !== "monorepo") {
+    return false;
+  }
+  if (templatePath.includes("/if-standalone/") && config.structure !== "standalone") {
+    return false;
+  }
+  if (templatePath.includes("/if-payload/") && config.marketingSite !== "payload") {
+    return false;
+  }
+  if (templatePath.includes("/if-posthog/") && config.integrations.analytics !== "posthog") {
+    return false;
+  }
+  if (templatePath.includes("/if-uploadthing/") && config.integrations.uploads !== "uploadthing") {
+    return false;
+  }
+  return true;
+}
+
+// src/templates.generated.ts
+var EMBEDDED_TEMPLATES = {
+  "base/_gitignore.hbs": "# Dependencies\nnode_modules\n.pnpm-store\n\n# Build outputs\n.next\ndist\n.turbo\nout\n\n# Testing\ncoverage\nplaywright-report\ntest-results\n\n# Environment\n.env\n.env.local\n.env.*.local\n\n# IDE\n.idea\n.vscode\n*.swp\n*.swo\n.DS_Store\n\n# Convex\n.convex\n\n# Vercel\n.vercel\n\n# Debug\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n.pnpm-debug.log*\n\n# TypeScript\n*.tsbuildinfo\n\n# Misc\n*.pem\n.cache\n",
+  "base/biome.json.hbs": '{\n  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",\n  "organizeImports": {\n    "enabled": true\n  },\n  "linter": {\n    "enabled": true,\n    "rules": {\n      "recommended": true\n    }\n  },\n  "formatter": {\n    "enabled": true,\n    "indentStyle": "space",\n    "indentWidth": 2\n  },\n  "javascript": {\n    "formatter": {\n      "quoteStyle": "single",\n      "semicolons": "asNeeded"\n    }\n  },\n  "files": {\n    "ignore": [\n      "node_modules",\n      ".next",\n      "dist",\n      ".turbo",\n      "coverage",\n      ".vercel",\n      "_generated"\n    ]\n  }\n}\n',
+  "convex/_env.local.hbs": "# Convex\nCONVEX_DEPLOYMENT=\nNEXT_PUBLIC_CONVEX_URL=\n\n# Auth - GitHub OAuth\nAUTH_GITHUB_ID=\nAUTH_GITHUB_SECRET=\n\n# Auth - Google OAuth\nAUTH_GOOGLE_ID=\nAUTH_GOOGLE_SECRET=\n\n# Better Auth Secret (generate with: openssl rand -base64 32)\nBETTER_AUTH_SECRET=\n{{#if (eq integrations.analytics 'posthog')}}\n\n# PostHog\nNEXT_PUBLIC_POSTHOG_KEY=\nNEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com\n{{/if}}\n{{#if (eq integrations.uploads 'uploadthing')}}\n\n# UploadThing\nUPLOADTHING_TOKEN=\n{{/if}}\n{{#if (eq integrations.uploads 's3')}}\n\n# AWS S3\nAWS_ACCESS_KEY_ID=\nAWS_SECRET_ACCESS_KEY=\nAWS_REGION=\nAWS_S3_BUCKET=\n{{/if}}\n{{#if (eq integrations.uploads 'vercel-blob')}}\n\n# Vercel Blob\nBLOB_READ_WRITE_TOKEN=\n{{/if}}\n{{#if (includes addons 'rate-limiting')}}\n\n# Arcjet\nARCJET_KEY=\n{{/if}}\n{{#if (includes addons 'monitoring')}}\n\n# Sentry\nSENTRY_DSN=\nSENTRY_AUTH_TOKEN=\n{{/if}}\n\n# Email (Resend)\nRESEND_API_KEY=\n",
+  "convex/convex/auth.ts.hbs": "import GitHub from '@auth/core/providers/github'\nimport Google from '@auth/core/providers/google'\nimport { convexAuth } from '@convex-dev/auth/server'\n\nexport const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({\n  providers: [GitHub, Google],\n})\n",
+  "convex/convex/http.ts.hbs": "import { httpRouter } from 'convex/server'\nimport { auth } from './auth'\n\nconst http = httpRouter()\n\nauth.addHttpRoutes(http)\n\nexport default http\n",
+  "convex/convex/schema.ts.hbs": "import { defineSchema, defineTable } from 'convex/server'\nimport { authTables } from '@convex-dev/auth/server'\nimport { v } from 'convex/values'\n\nexport default defineSchema({\n  ...authTables,\n  // Add your custom tables here\n  // Example:\n  // posts: defineTable({\n  //   title: v.string(),\n  //   content: v.string(),\n  //   authorId: v.id('users'),\n  //   createdAt: v.number(),\n  // }).index('by_author', ['authorId']),\n})\n",
+  "convex/convex/users.ts.hbs": "import { query } from './_generated/server'\nimport { auth } from './auth'\n\nexport const current = query({\n  args: {},\n  handler: async (ctx) => {\n    const userId = await auth.getUserId(ctx)\n    if (!userId) return null\n\n    const user = await ctx.db.get(userId)\n    return user\n  },\n})\n",
+  "integrations/posthog/src/components/providers/posthog-provider.tsx.hbs": "'use client'\n\nimport posthog from 'posthog-js'\nimport { PostHogProvider as PHProvider } from 'posthog-js/react'\nimport { useEffect } from 'react'\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n      api_host: process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com',\n      person_profiles: 'identified_only',\n      capture_pageview: false, // We capture pageviews manually\n    })\n  }, [])\n\n  return <PHProvider client={posthog}>{children}</PHProvider>\n}\n",
+  "monorepo/package.json.hbs": '{\n  "name": "{{projectName}}",\n  "version": "0.1.0",\n  "private": true,\n  "scripts": {\n    "dev": "node scripts/dev.mjs",\n    "dev:turbo": "turbo dev",\n    "build": "turbo build",\n    "lint": "turbo lint",\n    "lint:fix": "turbo lint:fix",\n    "format": "turbo format",\n    "typecheck": "turbo typecheck",\n    "test": "turbo test",\n    "test:e2e": "turbo test:e2e",\n    "clean": "turbo clean && rm -rf node_modules",\n    "prepare": "husky",\n    "setup:convex": "node apps/web/scripts/setup-convex.mjs"\n  },\n  "devDependencies": {\n    "turbo": "^2.0.0",\n    "husky": "^9.0.0",\n    "lint-staged": "^15.0.0"\n  },\n  "packageManager": "pnpm@9.0.0",\n  "lint-staged": {\n    "*.{js,ts,jsx,tsx}": ["biome check --apply"],\n    "*.{json,md}": ["biome format --write"]\n  }\n}\n',
+  "monorepo/pnpm-workspace.yaml.hbs": 'packages:\n  - "apps/*"\n  - "packages/*"\n',
+  "monorepo/turbo.json.hbs": '{\n  "$schema": "https://turbo.build/schema.json",\n  "ui": "tui",\n  "tasks": {\n    "build": {\n      "dependsOn": ["^build"],\n      "inputs": ["$TURBO_DEFAULT$", ".env*"],\n      "outputs": [".next/**", "!.next/cache/**", "dist/**"]\n    },\n    "lint": {\n      "dependsOn": ["^lint"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "lint:fix": {\n      "dependsOn": ["^lint:fix"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "format": {\n      "dependsOn": ["^format"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "typecheck": {\n      "dependsOn": ["^typecheck"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "dev": {\n      "cache": false,\n      "persistent": true\n    },\n    "test": {\n      "dependsOn": ["^build"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "test:e2e": {\n      "dependsOn": ["build"],\n      "inputs": ["$TURBO_DEFAULT$"]\n    },\n    "clean": {\n      "cache": false\n    }\n  }\n}\n',
+  "packages/config-biome/biome.json.hbs": '{\n  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",\n  "extends": ["../../biome.json"]\n}\n',
+  "packages/config-biome/package.json.hbs": '{\n  "name": "@repo/config-biome",\n  "version": "0.1.0",\n  "private": true,\n  "files": ["biome.json"]\n}\n',
+  "packages/config-typescript/base.json.hbs": '{\n  "compilerOptions": {\n    "target": "ES2020",\n    "lib": ["dom", "dom.iterable", "esnext"],\n    "allowJs": true,\n    "skipLibCheck": true,\n    "strict": true,\n    "noEmit": true,\n    "esModuleInterop": true,\n    "module": "esnext",\n    "moduleResolution": "bundler",\n    "resolveJsonModule": true,\n    "isolatedModules": true,\n    "incremental": true\n  },\n  "exclude": ["node_modules"]\n}\n',
+  "packages/config-typescript/nextjs.json.hbs": '{\n  "extends": "./base.json",\n  "compilerOptions": {\n    "jsx": "react-jsx",\n    "plugins": [{ "name": "next" }]\n  }\n}\n',
+  "packages/config-typescript/package.json.hbs": '{\n  "name": "@repo/config-typescript",\n  "version": "0.1.0",\n  "private": true,\n  "exports": {\n    "./base.json": "./base.json",\n    "./nextjs.json": "./nextjs.json"\n  },\n  "files": ["base.json", "nextjs.json"]\n}\n',
+  "packages/ui/components.json.hbs": '{\n  "$schema": "https://ui.shadcn.com/schema.json",\n  "style": "{{shadcn.componentLibrary}}-{{shadcn.styleVariant}}",\n  "rsc": false,\n  "tsx": true,\n  "tailwind": {\n    "config": "",\n    "css": "",\n    "baseColor": "{{shadcn.baseColor}}",\n    "cssVariables": true\n  },\n  "iconLibrary": "{{shadcn.iconLibrary}}",\n  "aliases": {\n    "components": "@/components",\n    "utils": "@/lib/utils",\n    "ui": "@/components/ui",\n    "lib": "@/lib",\n    "hooks": "@/hooks"\n  }\n}\n',
+  "packages/ui/package.json.hbs": '{\n  "name": "@repo/ui",\n  "version": "0.1.0",\n  "private": true,\n  "main": "./src/index.ts",\n  "types": "./src/index.ts",\n  "exports": {\n    ".": "./src/index.ts",\n    "./components/*": "./src/components/*.tsx",\n    "./lib/*": "./src/lib/*.ts"\n  },\n  "scripts": {\n    "lint": "biome check .",\n    "lint:fix": "biome check --write .",\n    "typecheck": "tsc --noEmit"\n  },\n  "dependencies": {\n    "@hugeicons/react": "^0.3.0",\n    "class-variance-authority": "^0.7.0",\n    "clsx": "^2.1.0",\n    "tailwind-merge": "^2.5.0"\n  },\n  "devDependencies": {\n    "@repo/config-typescript": "workspace:*",\n    "@types/react": "^19.0.0",\n    "@types/react-dom": "^19.0.0",\n    "react": "^19.0.0",\n    "tailwindcss": "^4.0.0",\n    "typescript": "^5.0.0"\n  },\n  "peerDependencies": {\n    "react": "^19.0.0"\n  }\n}\n',
+  "packages/ui/src/index.ts.hbs": "export { cn } from './lib/utils'\n// Export components as they are added\n// export * from './components/ui/button'\n",
+  "packages/ui/src/lib/utils.ts.hbs": "import { clsx, type ClassValue } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n",
+  "packages/ui/tsconfig.json.hbs": '{\n  "compilerOptions": {\n    "target": "ES2020",\n    "lib": ["dom", "dom.iterable", "esnext"],\n    "allowJs": true,\n    "skipLibCheck": true,\n    "strict": true,\n    "noEmit": true,\n    "esModuleInterop": true,\n    "module": "esnext",\n    "moduleResolution": "bundler",\n    "resolveJsonModule": true,\n    "isolatedModules": true,\n    "jsx": "react-jsx",\n    "incremental": true,\n    "paths": {\n      "@/*": ["./src/*"]\n    }\n  },\n  "include": ["src/**/*"],\n  "exclude": ["node_modules"]\n}\n',
+  "web/components.json.hbs": '{\n  "$schema": "https://ui.shadcn.com/schema.json",\n  "style": "{{shadcn.componentLibrary}}-{{shadcn.styleVariant}}",\n  "rsc": true,\n  "tsx": true,\n  "tailwind": {\n    "config": "",\n    "css": "src/app/globals.css",\n    "baseColor": "{{shadcn.baseColor}}",\n    "cssVariables": true\n  },\n  "iconLibrary": "{{shadcn.iconLibrary}}",\n  "aliases": {\n    "components": "@/components",\n    "utils": "@/lib/utils",\n    "ui": "@/components/ui",\n    "lib": "@/lib",\n    "hooks": "@/hooks"\n  }\n}\n',
+  "web/next.config.ts.hbs": "import type { NextConfig } from 'next'\n\nconst nextConfig: NextConfig = {\n{{#if (eq structure 'monorepo')}}\n  transpilePackages: ['@repo/ui', '@repo/backend'],\n{{/if}}\n}\n\nexport default nextConfig\n",
+  "web/package.json.hbs": `{
+  "name": "{{#if (eq structure 'monorepo')}}@repo/web{{else}}{{projectName}}{{/if}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "{{#if (eq structure 'monorepo')}}next dev --turbopack{{else}}node scripts/dev.mjs{{/if}}",
+    "dev:next": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "setup:convex": "node scripts/setup-convex.mjs"
+  },
+  "dependencies": {
+    "next": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "convex": "^1.25.0",
+    "@convex-dev/auth": "^0.0.90",
+    "@auth/core": "^0.37.0",
+    "@hugeicons/react": "^0.3.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.0",
+    "tailwind-merge": "^2.5.0",
+    "tw-animate-css": "^1.3.0",
+    "resend": "^4.0.0",
+    "react-email": "^3.0.0",
+    "@react-email/components": "^0.0.36"{{#if (eq integrations.analytics 'posthog')}},
+    "posthog-js": "^1.200.0",
+    "posthog-node": "^5.0.0"{{/if}}{{#if (eq integrations.analytics 'vercel')}},
+    "@vercel/analytics": "^1.4.0",
+    "@vercel/speed-insights": "^1.1.0"{{/if}}{{#if (eq integrations.uploads 'uploadthing')}},
+    "uploadthing": "^7.0.0",
+    "@uploadthing/react": "^7.0.0"{{/if}}{{#if (eq integrations.uploads 's3')}},
+    "@aws-sdk/client-s3": "^3.700.0",
+    "@aws-sdk/s3-request-presigner": "^3.700.0"{{/if}}{{#if (eq integrations.uploads 'vercel-blob')}},
+    "@vercel/blob": "^2.0.0"{{/if}}{{#if (includes addons 'rate-limiting')}},
+    "@arcjet/next": "^1.0.0-beta.16"{{/if}}{{#if (includes addons 'monitoring')}},
+    "@sentry/nextjs": "^8.0.0"{{/if}}
+  },
+  "devDependencies": {
+{{#if (eq structure 'monorepo')}}    "@repo/config-typescript": "workspace:*",
+{{/if}}    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "@tailwindcss/postcss": "^4.0.0",
+    "postcss": "^8.4.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "@testing-library/react": "^16.0.0",
+    "jsdom": "^26.0.0",
+    "playwright": "^1.50.0",
+    "@playwright/test": "^1.50.0"
+  }
+}
+`,
+  "web/postcss.config.mjs.hbs": "export default {\n  plugins: {\n    '@tailwindcss/postcss': {},\n  },\n}\n",
+  "web/src/app/globals.css.hbs": '@import "tailwindcss";\n@import "tw-animate-css";\n\n@custom-variant dark (&:is(.dark *));\n\n@theme inline {\n  --color-background: var(--background);\n  --color-foreground: var(--foreground);\n  --font-sans: var(--font-geist-sans);\n  --font-mono: var(--font-geist-mono);\n  --color-sidebar-ring: var(--sidebar-ring);\n  --color-sidebar-border: var(--sidebar-border);\n  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);\n  --color-sidebar-accent: var(--sidebar-accent);\n  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);\n  --color-sidebar-primary: var(--sidebar-primary);\n  --color-sidebar-foreground: var(--sidebar-foreground);\n  --color-sidebar: var(--sidebar);\n  --color-chart-5: var(--chart-5);\n  --color-chart-4: var(--chart-4);\n  --color-chart-3: var(--chart-3);\n  --color-chart-2: var(--chart-2);\n  --color-chart-1: var(--chart-1);\n  --color-ring: var(--ring);\n  --color-input: var(--input);\n  --color-border: var(--border);\n  --color-destructive: var(--destructive);\n  --color-accent-foreground: var(--accent-foreground);\n  --color-accent: var(--accent);\n  --color-muted-foreground: var(--muted-foreground);\n  --color-muted: var(--muted);\n  --color-secondary-foreground: var(--secondary-foreground);\n  --color-secondary: var(--secondary);\n  --color-primary-foreground: var(--primary-foreground);\n  --color-primary: var(--primary);\n  --color-popover-foreground: var(--popover-foreground);\n  --color-popover: var(--popover);\n  --color-card-foreground: var(--card-foreground);\n  --color-card: var(--card);\n  --radius-sm: calc(var(--radius) - 4px);\n  --radius-md: calc(var(--radius) - 2px);\n  --radius-lg: var(--radius);\n  --radius-xl: calc(var(--radius) + 4px);\n}\n\n:root {\n  --radius: 0.625rem;\n  --background: oklch(1 0 0);\n  --foreground: oklch(0.145 0 0);\n  --card: oklch(1 0 0);\n  --card-foreground: oklch(0.145 0 0);\n  --popover: oklch(1 0 0);\n  --popover-foreground: oklch(0.145 0 0);\n  --primary: oklch(0.205 0 0);\n  --primary-foreground: oklch(0.985 0 0);\n  --secondary: oklch(0.97 0 0);\n  --secondary-foreground: oklch(0.205 0 0);\n  --muted: oklch(0.97 0 0);\n  --muted-foreground: oklch(0.556 0 0);\n  --accent: oklch(0.97 0 0);\n  --accent-foreground: oklch(0.205 0 0);\n  --destructive: oklch(0.577 0.245 27.325);\n  --border: oklch(0.922 0 0);\n  --input: oklch(0.922 0 0);\n  --ring: oklch(0.708 0 0);\n  --chart-1: oklch(0.646 0.222 41.116);\n  --chart-2: oklch(0.6 0.118 184.704);\n  --chart-3: oklch(0.398 0.07 227.392);\n  --chart-4: oklch(0.828 0.189 84.429);\n  --chart-5: oklch(0.769 0.188 70.08);\n  --sidebar: oklch(0.985 0 0);\n  --sidebar-foreground: oklch(0.145 0 0);\n  --sidebar-primary: oklch(0.205 0 0);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.97 0 0);\n  --sidebar-accent-foreground: oklch(0.205 0 0);\n  --sidebar-border: oklch(0.922 0 0);\n  --sidebar-ring: oklch(0.708 0 0);\n}\n\n.dark {\n  --background: oklch(0.145 0 0);\n  --foreground: oklch(0.985 0 0);\n  --card: oklch(0.205 0 0);\n  --card-foreground: oklch(0.985 0 0);\n  --popover: oklch(0.205 0 0);\n  --popover-foreground: oklch(0.985 0 0);\n  --primary: oklch(0.922 0 0);\n  --primary-foreground: oklch(0.205 0 0);\n  --secondary: oklch(0.269 0 0);\n  --secondary-foreground: oklch(0.985 0 0);\n  --muted: oklch(0.269 0 0);\n  --muted-foreground: oklch(0.708 0 0);\n  --accent: oklch(0.269 0 0);\n  --accent-foreground: oklch(0.985 0 0);\n  --destructive: oklch(0.704 0.191 22.216);\n  --border: oklch(1 0 0 / 10%);\n  --input: oklch(1 0 0 / 15%);\n  --ring: oklch(0.556 0 0);\n  --chart-1: oklch(0.488 0.243 264.376);\n  --chart-2: oklch(0.696 0.17 162.48);\n  --chart-3: oklch(0.769 0.188 70.08);\n  --chart-4: oklch(0.627 0.265 303.9);\n  --chart-5: oklch(0.645 0.246 16.439);\n  --sidebar: oklch(0.205 0 0);\n  --sidebar-foreground: oklch(0.985 0 0);\n  --sidebar-primary: oklch(0.488 0.243 264.376);\n  --sidebar-primary-foreground: oklch(0.985 0 0);\n  --sidebar-accent: oklch(0.269 0 0);\n  --sidebar-accent-foreground: oklch(0.985 0 0);\n  --sidebar-border: oklch(1 0 0 / 10%);\n  --sidebar-ring: oklch(0.556 0 0);\n}\n\n@layer base {\n  * {\n    @apply border-border outline-ring/50;\n  }\n  body {\n    @apply bg-background text-foreground;\n  }\n}\n',
+  "web/src/app/layout.tsx.hbs": "import type { Metadata } from 'next'\nimport { Geist, Geist_Mono } from 'next/font/google'\nimport { ConvexAuthNextjsServerProvider } from '@convex-dev/auth/nextjs/server'\nimport { ConvexClientProvider } from '@/components/providers/convex-provider'\n{{#if (eq integrations.analytics 'posthog')}}\nimport { PostHogProvider } from '@/components/providers/posthog-provider'\n{{/if}}\n{{#if (eq integrations.analytics 'vercel')}}\nimport { Analytics } from '@vercel/analytics/react'\nimport { SpeedInsights } from '@vercel/speed-insights/next'\n{{/if}}\nimport './globals.css'\n\nconst geistSans = Geist({\n  variable: '--font-geist-sans',\n  subsets: ['latin'],\n})\n\nconst geistMono = Geist_Mono({\n  variable: '--font-geist-mono',\n  subsets: ['latin'],\n})\n\nexport const metadata: Metadata = {\n  title: '{{projectName}}',\n  description: 'Built with create-kofi-stack',\n}\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode\n}) {\n  return (\n    <ConvexAuthNextjsServerProvider>\n      <html lang=\"en\" suppressHydrationWarning>\n        <body className={`${geistSans.variable} ${geistMono.variable} antialiased`}>\n          <ConvexClientProvider>\n            {{#if (eq integrations.analytics 'posthog')}}\n            <PostHogProvider>\n              {children}\n            </PostHogProvider>\n            {{else}}\n            {children}\n            {{/if}}\n          </ConvexClientProvider>\n          {{#if (eq integrations.analytics 'vercel')}}\n          <Analytics />\n          <SpeedInsights />\n          {{/if}}\n        </body>\n      </html>\n    </ConvexAuthNextjsServerProvider>\n  )\n}\n",
+  "web/src/app/page.tsx.hbs": `'use client'
+
+import { useAuth } from '@/lib/auth'
+
+export default function HomePage() {
+  const { isAuthenticated, isLoading, signIn, signOut, user } = useAuth()
+
+  if (isLoading) {
+    return (
+      <main className="min-h-screen flex items-center justify-center">
+        <div className="animate-pulse">Loading...</div>
+      </main>
+    )
+  }
+
+  return (
+    <main className="min-h-screen flex flex-col items-center justify-center p-8">
+      <div className="max-w-2xl text-center space-y-8">
+        <h1 className="text-4xl font-bold">{{projectName}}</h1>
+        <p className="text-xl text-muted-foreground">
+          Built with Next.js, Convex, Better-Auth, and shadcn/ui
+        </p>
+
+        {isAuthenticated ? (
+          <div className="space-y-4">
+            <p className="text-lg">
+              Welcome, <span className="font-semibold">{user?.name || user?.email}</span>!
+            </p>
+            <button
+              onClick={() => signOut()}
+              className="px-6 py-2 bg-secondary text-secondary-foreground rounded-lg hover:opacity-90 transition"
+            >
+              Sign Out
+            </button>
+          </div>
+        ) : (
+          <div className="space-y-4">
+            <p className="text-muted-foreground">
+              Sign in to get started
+            </p>
+            <div className="flex gap-4 justify-center">
+              <button
+                onClick={() => signIn('github')}
+                className="px-6 py-2 bg-primary text-primary-foreground rounded-lg hover:opacity-90 transition"
+              >
+                Sign in with GitHub
+              </button>
+              <button
+                onClick={() => signIn('google')}
+                className="px-6 py-2 bg-secondary text-secondary-foreground rounded-lg hover:opacity-90 transition"
+              >
+                Sign in with Google
+              </button>
+            </div>
+          </div>
+        )}
+
+        <div className="pt-8 border-t border-border">
+          <p className="text-sm text-muted-foreground">
+            Created with{' '}
+            <a
+              href="https://github.com/theodenanyoh11/create-kofi-stack"
+              className="text-primary hover:underline"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              create-kofi-stack
+            </a>
+          </p>
+        </div>
+      </div>
+    </main>
+  )
+}
+`,
+  "web/src/components/providers/convex-provider.tsx.hbs": "'use client'\n\nimport { ConvexAuthNextjsProvider } from '@convex-dev/auth/nextjs'\nimport { ConvexReactClient } from 'convex/react'\n\nconst convex = new ConvexReactClient(process.env.NEXT_PUBLIC_CONVEX_URL!)\n\nexport function ConvexClientProvider({\n  children,\n}: {\n  children: React.ReactNode\n}) {\n  return (\n    <ConvexAuthNextjsProvider client={convex}>\n      {children}\n    </ConvexAuthNextjsProvider>\n  )\n}\n",
+  "web/src/lib/auth.ts.hbs": "'use client'\n\nimport { useConvexAuth, useMutation, useQuery } from 'convex/react'\nimport { useAuthActions } from '@convex-dev/auth/react'\nimport { api } from '{{#if (eq structure 'monorepo')}}@repo/backend{{else}}../../convex/_generated/api{{/if}}'\n\nexport function useAuth() {\n  const { isAuthenticated, isLoading } = useConvexAuth()\n  const { signIn, signOut } = useAuthActions()\n  const user = useQuery(api.users.current)\n\n  return {\n    isAuthenticated,\n    isLoading,\n    user,\n    signIn: (provider: 'github' | 'google') => {\n      void signIn(provider)\n    },\n    signOut: () => {\n      void signOut()\n    },\n  }\n}\n",
+  "web/src/lib/utils.ts.hbs": "import { clsx, type ClassValue } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n",
+  "web/tsconfig.json.hbs": '{\n  "compilerOptions": {\n    "target": "ES2017",\n    "lib": ["dom", "dom.iterable", "esnext"],\n    "allowJs": true,\n    "skipLibCheck": true,\n    "strict": true,\n    "noEmit": true,\n    "esModuleInterop": true,\n    "module": "esnext",\n    "moduleResolution": "bundler",\n    "resolveJsonModule": true,\n    "isolatedModules": true,\n    "jsx": "react-jsx",\n    "incremental": true,\n    "plugins": [{ "name": "next" }],\n    "paths": {\n      "@/*": ["./src/*"]\n    }\n  },\n  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts"],\n  "exclude": ["node_modules"]\n}\n'
+};
+
+// src/generator.ts
+import path3 from "path";
+async function generateVirtualProject(config) {
+  const vfs = new VirtualFileSystem();
+  const errors = [];
+  try {
+    await processBaseTemplates(vfs, config);
+    await processWebAppTemplates(vfs, config);
+    await processConvexTemplates(vfs, config);
+    await processBetterAuthTemplates(vfs, config);
+    if (config.structure === "monorepo") {
+      await processMonorepoTemplates(vfs, config);
+      if (config.marketingSite === "payload") {
+        await processPayloadTemplates(vfs, config);
+      } else if (config.marketingSite === "nextjs") {
+        await processMarketingTemplates(vfs, config);
+      }
+    }
+    await processIntegrationTemplates(vfs, config);
+    await processAddonTemplates(vfs, config);
+    await postProcess(vfs, config);
+    const tree = vfs.toTree(config);
+    return {
+      tree,
+      success: true
+    };
+  } catch (error) {
+    errors.push(error instanceof Error ? error.message : String(error));
+    return {
+      tree: vfs.toTree(config),
+      success: false,
+      errors
+    };
+  }
+}
+function processTemplatesFromPrefix(vfs, prefix, outputPrefix, config) {
+  for (const [templatePath, content] of Object.entries(EMBEDDED_TEMPLATES)) {
+    if (!templatePath.startsWith(prefix)) continue;
+    if (!shouldIncludeFile(templatePath, config)) continue;
+    const relativePath = templatePath.slice(prefix.length);
+    const outputPath = path3.join(outputPrefix, relativePath);
+    const dir = path3.dirname(outputPath);
+    const filename = path3.basename(outputPath);
+    const transformedFilename = transformFilename(filename, config);
+    const finalPath = path3.join(dir, transformedFilename);
+    if (isBinaryFile(filename)) {
+      vfs.writeFile(finalPath, Buffer.from(content, "base64"));
+    } else {
+      const processedContent = processTemplateString(content, config);
+      vfs.writeFile(finalPath, processedContent);
+    }
+  }
+}
+async function processBaseTemplates(vfs, config) {
+  processTemplatesFromPrefix(vfs, "base/", "/", config);
+}
+async function processWebAppTemplates(vfs, config) {
+  const appPath = config.structure === "monorepo" ? "/apps/web" : "/";
+  processTemplatesFromPrefix(vfs, "web/", appPath, config);
+}
+async function processConvexTemplates(vfs, config) {
+  const convexPath = config.structure === "monorepo" ? "/packages/backend" : "/";
+  processTemplatesFromPrefix(vfs, "convex/", convexPath, config);
+}
+async function processBetterAuthTemplates(vfs, config) {
+  const webPath = config.structure === "monorepo" ? "/apps/web" : "/";
+  processTemplatesFromPrefix(vfs, "auth/", webPath, config);
+}
+async function processMonorepoTemplates(vfs, config) {
+  processTemplatesFromPrefix(vfs, "monorepo/", "/", config);
+  processTemplatesFromPrefix(vfs, "packages/ui/", "/packages/ui", config);
+  processTemplatesFromPrefix(vfs, "packages/config/", "/packages/config", config);
+}
+async function processPayloadTemplates(vfs, config) {
+  processTemplatesFromPrefix(vfs, "marketing/payload/", "/apps/marketing", config);
+}
+async function processMarketingTemplates(vfs, config) {
+  processTemplatesFromPrefix(vfs, "marketing/nextjs/", "/apps/marketing", config);
+}
+async function processIntegrationTemplates(vfs, config) {
+  const webPath = config.structure === "monorepo" ? "/apps/web" : "/";
+  if (config.integrations.analytics === "posthog") {
+    processTemplatesFromPrefix(vfs, "integrations/posthog/", webPath, config);
+  }
+  if (config.integrations.analytics === "vercel") {
+    processTemplatesFromPrefix(vfs, "integrations/vercel-analytics/", webPath, config);
+  }
+  if (config.integrations.uploads === "uploadthing") {
+    processTemplatesFromPrefix(vfs, "integrations/uploadthing/", webPath, config);
+  }
+  if (config.integrations.uploads === "s3") {
+    processTemplatesFromPrefix(vfs, "integrations/s3/", webPath, config);
+  }
+  if (config.integrations.uploads === "vercel-blob") {
+    processTemplatesFromPrefix(vfs, "integrations/vercel-blob/", webPath, config);
+  }
+}
+async function processAddonTemplates(vfs, config) {
+  for (const addon of config.addons) {
+    processTemplatesFromPrefix(vfs, `addons/${addon}/`, "/", config);
+  }
+}
+async function postProcess(vfs, config) {
+  const scriptsPath = config.structure === "monorepo" ? "/scripts" : "/scripts";
+  const webScriptsPath = config.structure === "monorepo" ? "/apps/web/scripts" : "/scripts";
+  generateDevScript(vfs, scriptsPath, config);
+  generateSetupConvexScript(vfs, webScriptsPath, config);
+  generateReadme(vfs, config);
+}
+function generateDevScript(vfs, scriptsPath, config) {
+  const isMonorepo = config.structure === "monorepo";
+  const webAppDir = isMonorepo ? "apps/web" : ".";
+  const devScript = `#!/usr/bin/env node
+/**
+ * Dev Script - Starts Next.js and Convex dev servers
+ */
+
+import { spawn, execSync } from 'child_process'
+import { existsSync, readFileSync } from 'fs'
+import { resolve, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const rootDir = resolve(__dirname, '..')
+const webAppDir = resolve(rootDir, '${webAppDir}')
+
+function loadEnvFile(dir) {
+  const envPath = resolve(dir, '.env.local')
+  if (!existsSync(envPath)) return {}
+
+  const content = readFileSync(envPath, 'utf-8')
+  const env = {}
+
+  for (const line of content.split('\\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eqIndex = trimmed.indexOf('=')
+    if (eqIndex === -1) continue
+    const key = trimmed.slice(0, eqIndex)
+    let value = trimmed.slice(eqIndex + 1)
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1)
+    }
+    if (value) env[key] = value
+  }
+  return env
+}
+
+async function checkAndInstall() {
+  if (!existsSync(resolve(rootDir, 'node_modules'))) {
+    console.log('\u{1F4E6} Installing dependencies...\\n')
+    execSync('pnpm install', { cwd: rootDir, stdio: 'inherit' })
+  }
+}
+
+function startDevServers() {
+  const localEnv = loadEnvFile(webAppDir)
+
+  if (!localEnv.CONVEX_DEPLOYMENT) {
+    console.log('\u26A0\uFE0F  Convex not configured. Run: pnpm dev:setup\\n')
+    console.log('Starting Next.js only...\\n')
+    spawn('pnpm', ['${isMonorepo ? "dev:turbo" : "dev:next"}'], {
+      cwd: rootDir, stdio: 'inherit', shell: true
+    })
+    return
+  }
+
+  console.log('\u{1F680} Starting development servers...\\n')
+
+  const nextProcess = spawn('pnpm', ['${isMonorepo ? "dev:turbo" : "dev:next"}'], {
+    cwd: rootDir, stdio: 'inherit', shell: true
+  })
+
+  const convexProcess = spawn('npx', ['convex', 'dev'], {
+    cwd: webAppDir, stdio: 'inherit', shell: true
+  })
+
+  const cleanup = () => {
+    nextProcess.kill()
+    convexProcess.kill()
+    process.exit(0)
+  }
+
+  process.on('SIGINT', cleanup)
+  process.on('SIGTERM', cleanup)
+}
+
+async function main() {
+  await checkAndInstall()
+  startDevServers()
+}
+
+main()
+`;
+  vfs.writeFile(`${scriptsPath}/dev.mjs`, devScript);
+}
+function generateSetupConvexScript(vfs, scriptsPath, config) {
+  const setupScript = `#!/usr/bin/env node
+/**
+ * Setup Convex - Interactive setup wizard for Convex
+ */
+
+import { execSync, spawnSync } from 'child_process'
+import { existsSync, readFileSync, writeFileSync } from 'fs'
+import { resolve, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import * as readline from 'readline'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const projectDir = resolve(__dirname, '..')
+
+function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close()
+      resolve(answer.trim())
+    })
+  })
+}
+
+async function main() {
+  console.log('\\n\u{1F527} Convex Setup Wizard\\n')
+
+  // Check if already configured
+  const envPath = resolve(projectDir, '.env.local')
+  if (existsSync(envPath)) {
+    const content = readFileSync(envPath, 'utf-8')
+    if (content.includes('CONVEX_DEPLOYMENT=') && !content.includes('CONVEX_DEPLOYMENT=\\n')) {
+      console.log('\u2705 Convex is already configured!')
+      console.log('   Run "pnpm dev" to start development.\\n')
+      return
+    }
+  }
+
+  console.log('This wizard will help you set up Convex for your project.\\n')
+
+  // Run convex dev to trigger authentication and project creation
+  console.log('Running Convex setup (this will open your browser if needed)...\\n')
+
+  try {
+    spawnSync('npx', ['convex', 'dev', '--once'], {
+      cwd: projectDir,
+      stdio: 'inherit',
+      shell: true
+    })
+
+    console.log('\\n\u2705 Convex setup complete!')
+    console.log('   Run "pnpm dev" to start development.\\n')
+  } catch (error) {
+    console.error('\\n\u274C Convex setup failed:', error.message)
+    console.error('   Try running "npx convex dev" manually.\\n')
+    process.exit(1)
+  }
+}
+
+main()
+`;
+  vfs.writeFile(`${scriptsPath}/setup-convex.mjs`, setupScript);
+}
+function generateReadme(vfs, config) {
+  const readme = `# ${config.projectName}
+
+Built with [create-kofi-stack](https://github.com/theodenanyoh11/create-kofi-stack)
+
+## Tech Stack
+
+- **Framework**: Next.js 16 with App Router
+- **Backend**: Convex (reactive backend-as-a-service)
+- **Auth**: Better-Auth with Convex adapter
+- **UI**: shadcn/ui with ${config.shadcn.componentLibrary}
+- **Styling**: Tailwind CSS v4
+
+## Getting Started
+
+\`\`\`bash
+cd ${config.projectName}
+pnpm dev
+\`\`\`
+
+This will:
+- Install dependencies (if needed)
+- Set up Convex (if not configured)
+- Start Next.js and Convex dev servers
+
+## Project Structure
+
+${config.structure === "monorepo" ? `
+\`\`\`
+\u251C\u2500\u2500 apps/
+\u2502   \u251C\u2500\u2500 web/          # Main Next.js application
+\u2502   ${config.marketingSite !== "none" ? "\u251C\u2500\u2500 marketing/    # Marketing site" : ""}
+\u2502   \u2514\u2500\u2500 design-system/ # Component showcase
+\u251C\u2500\u2500 packages/
+\u2502   \u251C\u2500\u2500 backend/      # Convex functions
+\u2502   \u2514\u2500\u2500 ui/           # Shared UI components
+\u2514\u2500\u2500 ...
+\`\`\`
+` : `
+\`\`\`
+\u251C\u2500\u2500 src/
+\u2502   \u251C\u2500\u2500 app/          # Next.js App Router
+\u2502   \u251C\u2500\u2500 components/   # React components
+\u2502   \u2514\u2500\u2500 lib/          # Utilities
+\u251C\u2500\u2500 convex/           # Convex functions
+\u2514\u2500\u2500 ...
+\`\`\`
+`}
+
+## Documentation
+
+- [Convex](https://docs.convex.dev)
+- [Better-Auth](https://www.better-auth.com)
+- [shadcn/ui](https://ui.shadcn.com)
+- [Next.js](https://nextjs.org/docs)
+`;
+  vfs.writeFile("/README.md", readme);
+}
+export {
+  VirtualFileSystem,
+  generateVirtualProject,
+  isBinaryFile,
+  processTemplateString,
+  shouldIncludeFile,
+  transformFilename
+};