kofi-stack-template-generator 2.0.0

package/src/generator.ts

@@ -0,0 +1,429 @@
+import type {
+  ProjectConfig,
+  VirtualFileTree,
+  GeneratorResult,
+} from 'kofi-stack-types'
+import { VirtualFileSystem } from './core/virtual-fs.js'
+import {
+  processTemplateString,
+  transformFilename,
+  isBinaryFile,
+  shouldIncludeFile,
+} from './core/template-processor.js'
+import { EMBEDDED_TEMPLATES } from './templates.generated.js'
+import path from 'path'
+
+/**
+ * Generate a virtual project based on the provided configuration.
+ * Returns a VirtualFileTree that can be written to disk.
+ */
+export async function generateVirtualProject(
+  config: ProjectConfig
+): Promise<GeneratorResult> {
+  const vfs = new VirtualFileSystem()
+  const errors: string[] = []
+
+  try {
+    // Process templates in order
+    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)
+
+    // Post-processing: Generate package.json, README, etc.
+    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,
+    }
+  }
+}
+
+/**
+ * Process templates from a given prefix path
+ */
+function processTemplatesFromPrefix(
+  vfs: VirtualFileSystem,
+  prefix: string,
+  outputPrefix: string,
+  config: ProjectConfig
+): void {
+  for (const [templatePath, content] of Object.entries(EMBEDDED_TEMPLATES)) {
+    if (!templatePath.startsWith(prefix)) continue
+    if (!shouldIncludeFile(templatePath, config)) continue
+
+    // Calculate output path
+    const relativePath = templatePath.slice(prefix.length)
+    const outputPath = path.join(outputPrefix, relativePath)
+
+    // Transform filename
+    const dir = path.dirname(outputPath)
+    const filename = path.basename(outputPath)
+    const transformedFilename = transformFilename(filename, config)
+    const finalPath = path.join(dir, transformedFilename)
+
+    // Process content
+    if (isBinaryFile(filename)) {
+      // For binary files, we store the source path for later copying
+      vfs.writeFile(finalPath, Buffer.from(content, 'base64'))
+    } else {
+      // Process as template
+      const processedContent = processTemplateString(content, config)
+      vfs.writeFile(finalPath, processedContent)
+    }
+  }
+}
+
+async function processBaseTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  processTemplatesFromPrefix(vfs, 'base/', '/', config)
+}
+
+async function processWebAppTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  const appPath = config.structure === 'monorepo' ? '/apps/web' : '/'
+  processTemplatesFromPrefix(vfs, 'web/', appPath, config)
+}
+
+async function processConvexTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  const convexPath = config.structure === 'monorepo' ? '/packages/backend' : '/'
+  processTemplatesFromPrefix(vfs, 'convex/', convexPath, config)
+}
+
+async function processBetterAuthTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  const webPath = config.structure === 'monorepo' ? '/apps/web' : '/'
+  processTemplatesFromPrefix(vfs, 'auth/', webPath, config)
+}
+
+async function processMonorepoTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  processTemplatesFromPrefix(vfs, 'monorepo/', '/', config)
+  processTemplatesFromPrefix(vfs, 'packages/ui/', '/packages/ui', config)
+  processTemplatesFromPrefix(vfs, 'packages/config/', '/packages/config', config)
+}
+
+async function processPayloadTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  processTemplatesFromPrefix(vfs, 'marketing/payload/', '/apps/marketing', config)
+}
+
+async function processMarketingTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  processTemplatesFromPrefix(vfs, 'marketing/nextjs/', '/apps/marketing', config)
+}
+
+async function processIntegrationTemplates(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  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: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  for (const addon of config.addons) {
+    processTemplatesFromPrefix(vfs, `addons/${addon}/`, '/', config)
+  }
+}
+
+async function postProcess(
+  vfs: VirtualFileSystem,
+  config: ProjectConfig
+): Promise<void> {
+  // Generate scripts directory with dev.mjs and setup scripts
+  const scriptsPath = config.structure === 'monorepo' ? '/scripts' : '/scripts'
+  const webScriptsPath = config.structure === 'monorepo' ? '/apps/web/scripts' : '/scripts'
+
+  generateDevScript(vfs, scriptsPath, config)
+  generateSetupConvexScript(vfs, webScriptsPath, config)
+
+  // Generate README
+  generateReadme(vfs, config)
+}
+
+function generateDevScript(
+  vfs: VirtualFileSystem,
+  scriptsPath: string,
+  config: ProjectConfig
+): void {
+  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('📦 Installing dependencies...\\n')
+    execSync('pnpm install', { cwd: rootDir, stdio: 'inherit' })
+  }
+}
+
+function startDevServers() {
+  const localEnv = loadEnvFile(webAppDir)
+
+  if (!localEnv.CONVEX_DEPLOYMENT) {
+    console.log('⚠️  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('🚀 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: VirtualFileSystem,
+  scriptsPath: string,
+  config: ProjectConfig
+): void {
+  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🔧 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('✅ 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✅ Convex setup complete!')
+    console.log('   Run "pnpm dev" to start development.\\n')
+  } catch (error) {
+    console.error('\\n❌ 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: VirtualFileSystem, config: ProjectConfig): void {
+  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' ? `
+\`\`\`
+├── apps/
+│   ├── web/          # Main Next.js application
+│   ${config.marketingSite !== 'none' ? '├── marketing/    # Marketing site' : ''}
+│   └── design-system/ # Component showcase
+├── packages/
+│   ├── backend/      # Convex functions
+│   └── ui/           # Shared UI components
+└── ...
+\`\`\`
+` : `
+\`\`\`
+├── src/
+│   ├── app/          # Next.js App Router
+│   ├── components/   # React components
+│   └── lib/          # Utilities
+├── convex/           # Convex functions
+└── ...
+\`\`\`
+`}
+
+## 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 }

package/src/index.ts

@@ -0,0 +1,19 @@
+// Main generator
+export { generateVirtualProject, VirtualFileSystem } from './generator.js'
+
+// Core utilities
+export {
+  processTemplateString,
+  transformFilename,
+  isBinaryFile,
+  shouldIncludeFile,
+} from './core/template-processor.js'
+
+// Re-export types
+export type {
+  ProjectConfig,
+  VirtualFileTree,
+  VirtualFile,
+  VirtualDirectory,
+  GeneratorResult,
+} from 'kofi-stack-types'

package/src/templates.generated.ts

@@ -0,0 +1,39 @@
+// Auto-generated file. Do not edit manually.
+// Run 'pnpm prebuild' to regenerate.
+// Generated: 2026-01-13T20:11:02.957Z
+// Template count: 32
+
+export const EMBEDDED_TEMPLATES: Record<string, string> = {
+  "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": "{\n  \"name\": \"{{#if (eq structure 'monorepo')}}@repo/web{{else}}{{projectName}}{{/if}}\",\n  \"version\": \"0.1.0\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"scripts\": {\n    \"dev\": \"{{#if (eq structure 'monorepo')}}next dev --turbopack{{else}}node scripts/dev.mjs{{/if}}\",\n    \"dev:next\": \"next dev --turbopack\",\n    \"build\": \"next build\",\n    \"start\": \"next start\",\n    \"lint\": \"biome check .\",\n    \"lint:fix\": \"biome check --write .\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:e2e\": \"playwright test\",\n    \"setup:convex\": \"node scripts/setup-convex.mjs\"\n  },\n  \"dependencies\": {\n    \"next\": \"^16.0.0\",\n    \"react\": \"^19.0.0\",\n    \"react-dom\": \"^19.0.0\",\n    \"convex\": \"^1.25.0\",\n    \"@convex-dev/auth\": \"^0.0.90\",\n    \"@auth/core\": \"^0.37.0\",\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    \"tw-animate-css\": \"^1.3.0\",\n    \"resend\": \"^4.0.0\",\n    \"react-email\": \"^3.0.0\",\n    \"@react-email/components\": \"^0.0.36\"{{#if (eq integrations.analytics 'posthog')}},\n    \"posthog-js\": \"^1.200.0\",\n    \"posthog-node\": \"^5.0.0\"{{/if}}{{#if (eq integrations.analytics 'vercel')}},\n    \"@vercel/analytics\": \"^1.4.0\",\n    \"@vercel/speed-insights\": \"^1.1.0\"{{/if}}{{#if (eq integrations.uploads 'uploadthing')}},\n    \"uploadthing\": \"^7.0.0\",\n    \"@uploadthing/react\": \"^7.0.0\"{{/if}}{{#if (eq integrations.uploads 's3')}},\n    \"@aws-sdk/client-s3\": \"^3.700.0\",\n    \"@aws-sdk/s3-request-presigner\": \"^3.700.0\"{{/if}}{{#if (eq integrations.uploads 'vercel-blob')}},\n    \"@vercel/blob\": \"^2.0.0\"{{/if}}{{#if (includes addons 'rate-limiting')}},\n    \"@arcjet/next\": \"^1.0.0-beta.16\"{{/if}}{{#if (includes addons 'monitoring')}},\n    \"@sentry/nextjs\": \"^8.0.0\"{{/if}}\n  },\n  \"devDependencies\": {\n{{#if (eq structure 'monorepo')}}    \"@repo/config-typescript\": \"workspace:*\",\n{{/if}}    \"@types/node\": \"^20.0.0\",\n    \"@types/react\": \"^19.0.0\",\n    \"@types/react-dom\": \"^19.0.0\",\n    \"tailwindcss\": \"^4.0.0\",\n    \"@tailwindcss/postcss\": \"^4.0.0\",\n    \"postcss\": \"^8.4.0\",\n    \"typescript\": \"^5.0.0\",\n    \"vitest\": \"^3.0.0\",\n    \"@vitejs/plugin-react\": \"^4.3.0\",\n    \"@testing-library/react\": \"^16.0.0\",\n    \"jsdom\": \"^26.0.0\",\n    \"playwright\": \"^1.50.0\",\n    \"@playwright/test\": \"^1.50.0\"\n  }\n}\n",
+  "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'\n\nimport { useAuth } from '@/lib/auth'\n\nexport default function HomePage() {\n  const { isAuthenticated, isLoading, signIn, signOut, user } = useAuth()\n\n  if (isLoading) {\n    return (\n      <main className=\"min-h-screen flex items-center justify-center\">\n        <div className=\"animate-pulse\">Loading...</div>\n      </main>\n    )\n  }\n\n  return (\n    <main className=\"min-h-screen flex flex-col items-center justify-center p-8\">\n      <div className=\"max-w-2xl text-center space-y-8\">\n        <h1 className=\"text-4xl font-bold\">{{projectName}}</h1>\n        <p className=\"text-xl text-muted-foreground\">\n          Built with Next.js, Convex, Better-Auth, and shadcn/ui\n        </p>\n\n        {isAuthenticated ? (\n          <div className=\"space-y-4\">\n            <p className=\"text-lg\">\n              Welcome, <span className=\"font-semibold\">{user?.name || user?.email}</span>!\n            </p>\n            <button\n              onClick={() => signOut()}\n              className=\"px-6 py-2 bg-secondary text-secondary-foreground rounded-lg hover:opacity-90 transition\"\n            >\n              Sign Out\n            </button>\n          </div>\n        ) : (\n          <div className=\"space-y-4\">\n            <p className=\"text-muted-foreground\">\n              Sign in to get started\n            </p>\n            <div className=\"flex gap-4 justify-center\">\n              <button\n                onClick={() => signIn('github')}\n                className=\"px-6 py-2 bg-primary text-primary-foreground rounded-lg hover:opacity-90 transition\"\n              >\n                Sign in with GitHub\n              </button>\n              <button\n                onClick={() => signIn('google')}\n                className=\"px-6 py-2 bg-secondary text-secondary-foreground rounded-lg hover:opacity-90 transition\"\n              >\n                Sign in with Google\n              </button>\n            </div>\n          </div>\n        )}\n\n        <div className=\"pt-8 border-t border-border\">\n          <p className=\"text-sm text-muted-foreground\">\n            Created with{' '}\n            <a\n              href=\"https://github.com/theodenanyoh11/create-kofi-stack\"\n              className=\"text-primary hover:underline\"\n              target=\"_blank\"\n              rel=\"noopener noreferrer\"\n            >\n              create-kofi-stack\n            </a>\n          </p>\n        </div>\n      </div>\n    </main>\n  )\n}\n",
+  "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"
+}

package/templates/base/_gitignore.hbs

@@ -0,0 +1,45 @@
+# Dependencies
+node_modules
+.pnpm-store
+
+# Build outputs
+.next
+dist
+.turbo
+out
+
+# Testing
+coverage
+playwright-report
+test-results
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+.DS_Store
+
+# Convex
+.convex
+
+# Vercel
+.vercel
+
+# Debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# TypeScript
+*.tsbuildinfo
+
+# Misc
+*.pem
+.cache

package/templates/base/biome.json.hbs

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true
+    }
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "asNeeded"
+    }
+  },
+  "files": {
+    "ignore": [
+      "node_modules",
+      ".next",
+      "dist",
+      ".turbo",
+      "coverage",
+      ".vercel",
+      "_generated"
+    ]
+  }
+}

package/templates/convex/_env.local.hbs

@@ -0,0 +1,52 @@
+# Convex
+CONVEX_DEPLOYMENT=
+NEXT_PUBLIC_CONVEX_URL=
+
+# Auth - GitHub OAuth
+AUTH_GITHUB_ID=
+AUTH_GITHUB_SECRET=
+
+# Auth - Google OAuth
+AUTH_GOOGLE_ID=
+AUTH_GOOGLE_SECRET=
+
+# Better Auth Secret (generate with: openssl rand -base64 32)
+BETTER_AUTH_SECRET=
+{{#if (eq integrations.analytics 'posthog')}}
+
+# PostHog
+NEXT_PUBLIC_POSTHOG_KEY=
+NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com
+{{/if}}
+{{#if (eq integrations.uploads 'uploadthing')}}
+
+# UploadThing
+UPLOADTHING_TOKEN=
+{{/if}}
+{{#if (eq integrations.uploads 's3')}}
+
+# AWS S3
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_REGION=
+AWS_S3_BUCKET=
+{{/if}}
+{{#if (eq integrations.uploads 'vercel-blob')}}
+
+# Vercel Blob
+BLOB_READ_WRITE_TOKEN=
+{{/if}}
+{{#if (includes addons 'rate-limiting')}}
+
+# Arcjet
+ARCJET_KEY=
+{{/if}}
+{{#if (includes addons 'monitoring')}}
+
+# Sentry
+SENTRY_DSN=
+SENTRY_AUTH_TOKEN=
+{{/if}}
+
+# Email (Resend)
+RESEND_API_KEY=