kofi-stack-template-generator 2.0.0

package/templates/convex/convex/auth.ts.hbs

@@ -0,0 +1,7 @@
+import GitHub from '@auth/core/providers/github'
+import Google from '@auth/core/providers/google'
+import { convexAuth } from '@convex-dev/auth/server'
+
+export const { auth, signIn, signOut, store, isAuthenticated } = convexAuth({
+  providers: [GitHub, Google],
+})

package/templates/convex/convex/http.ts.hbs

@@ -0,0 +1,8 @@
+import { httpRouter } from 'convex/server'
+import { auth } from './auth'
+
+const http = httpRouter()
+
+auth.addHttpRoutes(http)
+
+export default http

package/templates/convex/convex/schema.ts.hbs

@@ -0,0 +1,15 @@
+import { defineSchema, defineTable } from 'convex/server'
+import { authTables } from '@convex-dev/auth/server'
+import { v } from 'convex/values'
+
+export default defineSchema({
+  ...authTables,
+  // Add your custom tables here
+  // Example:
+  // posts: defineTable({
+  //   title: v.string(),
+  //   content: v.string(),
+  //   authorId: v.id('users'),
+  //   createdAt: v.number(),
+  // }).index('by_author', ['authorId']),
+})

package/templates/convex/convex/users.ts.hbs

@@ -0,0 +1,13 @@
+import { query } from './_generated/server'
+import { auth } from './auth'
+
+export const current = query({
+  args: {},
+  handler: async (ctx) => {
+    const userId = await auth.getUserId(ctx)
+    if (!userId) return null
+
+    const user = await ctx.db.get(userId)
+    return user
+  },
+})

package/templates/integrations/posthog/src/components/providers/posthog-provider.tsx.hbs

@@ -0,0 +1,17 @@
+'use client'
+
+import posthog from 'posthog-js'
+import { PostHogProvider as PHProvider } from 'posthog-js/react'
+import { useEffect } from 'react'
+
+export function PostHogProvider({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+      api_host: process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com',
+      person_profiles: 'identified_only',
+      capture_pageview: false, // We capture pageviews manually
+    })
+  }, [])
+
+  return <PHProvider client={posthog}>{children}</PHProvider>
+}

package/templates/monorepo/package.json.hbs

@@ -0,0 +1,29 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "node scripts/dev.mjs",
+    "dev:turbo": "turbo dev",
+    "build": "turbo build",
+    "lint": "turbo lint",
+    "lint:fix": "turbo lint:fix",
+    "format": "turbo format",
+    "typecheck": "turbo typecheck",
+    "test": "turbo test",
+    "test:e2e": "turbo test:e2e",
+    "clean": "turbo clean && rm -rf node_modules",
+    "prepare": "husky",
+    "setup:convex": "node apps/web/scripts/setup-convex.mjs"
+  },
+  "devDependencies": {
+    "turbo": "^2.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0"
+  },
+  "packageManager": "pnpm@9.0.0",
+  "lint-staged": {
+    "*.{js,ts,jsx,tsx}": ["biome check --apply"],
+    "*.{json,md}": ["biome format --write"]
+  }
+}

package/templates/monorepo/pnpm-workspace.yaml.hbs

@@ -0,0 +1,3 @@
+packages:
+  - "apps/*"
+  - "packages/*"

package/templates/monorepo/turbo.json.hbs

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "ui": "tui",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": ["$TURBO_DEFAULT$", ".env*"],
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
+    },
+    "lint": {
+      "dependsOn": ["^lint"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "lint:fix": {
+      "dependsOn": ["^lint:fix"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "format": {
+      "dependsOn": ["^format"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "typecheck": {
+      "dependsOn": ["^typecheck"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "test": {
+      "dependsOn": ["^build"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "test:e2e": {
+      "dependsOn": ["build"],
+      "inputs": ["$TURBO_DEFAULT$"]
+    },
+    "clean": {
+      "cache": false
+    }
+  }
+}

package/templates/packages/config-biome/biome.json.hbs

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "extends": ["../../biome.json"]
+}

package/templates/packages/config-biome/package.json.hbs

@@ -0,0 +1,6 @@
+{
+  "name": "@repo/config-biome",
+  "version": "0.1.0",
+  "private": true,
+  "files": ["biome.json"]
+}

package/templates/packages/config-typescript/base.json.hbs

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "incremental": true
+  },
+  "exclude": ["node_modules"]
+}

package/templates/packages/config-typescript/nextjs.json.hbs

@@ -0,0 +1,7 @@
+{
+  "extends": "./base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "plugins": [{ "name": "next" }]
+  }
+}

package/templates/packages/config-typescript/package.json.hbs

@@ -0,0 +1,10 @@
+{
+  "name": "@repo/config-typescript",
+  "version": "0.1.0",
+  "private": true,
+  "exports": {
+    "./base.json": "./base.json",
+    "./nextjs.json": "./nextjs.json"
+  },
+  "files": ["base.json", "nextjs.json"]
+}

package/templates/packages/ui/components.json.hbs

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "{{shadcn.componentLibrary}}-{{shadcn.styleVariant}}",
+  "rsc": false,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "",
+    "baseColor": "{{shadcn.baseColor}}",
+    "cssVariables": true
+  },
+  "iconLibrary": "{{shadcn.iconLibrary}}",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/templates/packages/ui/package.json.hbs

@@ -0,0 +1,34 @@
+{
+  "name": "@repo/ui",
+  "version": "0.1.0",
+  "private": true,
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./components/*": "./src/components/*.tsx",
+    "./lib/*": "./src/lib/*.ts"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@hugeicons/react": "^0.3.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.0",
+    "tailwind-merge": "^2.5.0"
+  },
+  "devDependencies": {
+    "@repo/config-typescript": "workspace:*",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0"
+  }
+}

package/templates/packages/ui/src/index.ts.hbs

@@ -0,0 +1,3 @@
+export { cn } from './lib/utils'
+// Export components as they are added
+// export * from './components/ui/button'

package/templates/packages/ui/src/lib/utils.ts.hbs

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/templates/packages/ui/tsconfig.json.hbs

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}

package/templates/web/components.json.hbs

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "{{shadcn.componentLibrary}}-{{shadcn.styleVariant}}",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/globals.css",
+    "baseColor": "{{shadcn.baseColor}}",
+    "cssVariables": true
+  },
+  "iconLibrary": "{{shadcn.iconLibrary}}",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/templates/web/next.config.ts.hbs

@@ -0,0 +1,9 @@
+import type { NextConfig } from 'next'
+
+const nextConfig: NextConfig = {
+{{#if (eq structure 'monorepo')}}
+  transpilePackages: ['@repo/ui', '@repo/backend'],
+{{/if}}
+}
+
+export default nextConfig

package/templates/web/package.json.hbs

@@ -0,0 +1,62 @@
+{
+  "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"
+  }
+}

package/templates/web/postcss.config.mjs.hbs

@@ -0,0 +1,5 @@
+export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}

package/templates/web/src/app/globals.css.hbs

@@ -0,0 +1,122 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+  --color-sidebar-ring: var(--sidebar-ring);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar: var(--sidebar);
+  --color-chart-5: var(--chart-5);
+  --color-chart-4: var(--chart-4);
+  --color-chart-3: var(--chart-3);
+  --color-chart-2: var(--chart-2);
+  --color-chart-1: var(--chart-1);
+  --color-ring: var(--ring);
+  --color-input: var(--input);
+  --color-border: var(--border);
+  --color-destructive: var(--destructive);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-accent: var(--accent);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-muted: var(--muted);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-secondary: var(--secondary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-primary: var(--primary);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-popover: var(--popover);
+  --color-card-foreground: var(--card-foreground);
+  --color-card: var(--card);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+}
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/templates/web/src/app/layout.tsx.hbs

@@ -0,0 +1,55 @@
+import type { Metadata } from 'next'
+import { Geist, Geist_Mono } from 'next/font/google'
+import { ConvexAuthNextjsServerProvider } from '@convex-dev/auth/nextjs/server'
+import { ConvexClientProvider } from '@/components/providers/convex-provider'
+{{#if (eq integrations.analytics 'posthog')}}
+import { PostHogProvider } from '@/components/providers/posthog-provider'
+{{/if}}
+{{#if (eq integrations.analytics 'vercel')}}
+import { Analytics } from '@vercel/analytics/react'
+import { SpeedInsights } from '@vercel/speed-insights/next'
+{{/if}}
+import './globals.css'
+
+const geistSans = Geist({
+  variable: '--font-geist-sans',
+  subsets: ['latin'],
+})
+
+const geistMono = Geist_Mono({
+  variable: '--font-geist-mono',
+  subsets: ['latin'],
+})
+
+export const metadata: Metadata = {
+  title: '{{projectName}}',
+  description: 'Built with create-kofi-stack',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <ConvexAuthNextjsServerProvider>
+      <html lang="en" suppressHydrationWarning>
+        <body className={`${geistSans.variable} ${geistMono.variable} antialiased`}>
+          <ConvexClientProvider>
+            {{#if (eq integrations.analytics 'posthog')}}
+            <PostHogProvider>
+              {children}
+            </PostHogProvider>
+            {{else}}
+            {children}
+            {{/if}}
+          </ConvexClientProvider>
+          {{#if (eq integrations.analytics 'vercel')}}
+          <Analytics />
+          <SpeedInsights />
+          {{/if}}
+        </body>
+      </html>
+    </ConvexAuthNextjsServerProvider>
+  )
+}

package/templates/web/src/app/page.tsx.hbs

@@ -0,0 +1,74 @@
+'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>
+  )
+}

package/templates/web/src/components/providers/convex-provider.tsx.hbs

@@ -0,0 +1,18 @@
+'use client'
+
+import { ConvexAuthNextjsProvider } from '@convex-dev/auth/nextjs'
+import { ConvexReactClient } from 'convex/react'
+
+const convex = new ConvexReactClient(process.env.NEXT_PUBLIC_CONVEX_URL!)
+
+export function ConvexClientProvider({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <ConvexAuthNextjsProvider client={convex}>
+      {children}
+    </ConvexAuthNextjsProvider>
+  )
+}