create-kofi-stack 1.2.18 → 1.2.20

package/dist/index.js

@@ -80,16 +80,6 @@ async function promptMarketingSite(defaultValue) {
   }
   return marketing;
 }
-async function promptIncludeDocs(defaultValue) {
-  const includeDocs = await p.confirm({
-    message: "Include documentation site? (Fumadocs)",
-    initialValue: defaultValue ?? true
-  });
-  if (p.isCancel(includeDocs)) {
-    throw new Error("Operation cancelled");
-  }
-  return includeDocs;
-}
 
 // src/prompts/shadcn.ts
 import * as p2 from "@clack/prompts";
@@ -471,7 +461,6 @@ function parseOptions(options) {
     monorepo: options.monorepo,
     single: options.single,
     marketing: options.marketing,
-    docs: options.docs,
     componentLibrary: options.componentLibrary,
     style: options.style,
     baseColor: options.baseColor,
@@ -505,18 +494,12 @@ async function runPrompts(projectName, rawOptions) {
     structure = await promptProjectStructure();
   }
   let marketingSite = "none";
-  let includeDocs = false;
   if (structure === "monorepo") {
     if (options.marketing) {
       marketingSite = options.marketing;
     } else {
       marketingSite = await promptMarketingSite();
     }
-    if (options.docs !== void 0) {
-      includeDocs = options.docs;
-    } else {
-      includeDocs = await promptIncludeDocs();
-    }
   }
   const shadcn = await promptShadcnConfig({
     componentLibrary: options.componentLibrary,
@@ -569,7 +552,6 @@ async function runPrompts(projectName, rawOptions) {
     name,
     structure,
     marketingSite,
-    includeDocs,
     shadcn,
     designSystem,
     auth,
@@ -614,9 +596,6 @@ function showConfigSummary(config) {
     if (config.marketingSite !== "none") {
       apps.push(`marketing (${config.marketingSite})`);
     }
-    if (config.includeDocs) {
-      apps.push("docs");
-    }
   }
   const authProviders = ["Email/Password", "Google", ...config.auth.providers];
   const extras = [];
@@ -660,9 +639,6 @@ async function showConfirmation(config) {
     if (config.marketingSite !== "none") {
       apps.push(`marketing (${config.marketingSite})`);
     }
-    if (config.includeDocs) {
-      apps.push("docs");
-    }
   }
   const authProviders = ["Email/Password", "Google", ...config.auth.providers];
   const extras = [];
@@ -709,7 +685,7 @@ ${extras.length > 0 ? `${pc.bold("Extras:")} ${extras.join(", ")}` : ""}`,
 }
 
 // src/generators/index.ts
-import path19 from "path";
+import path18 from "path";
 import * as p7 from "@clack/prompts";
 import pc3 from "picocolors";
 import ora from "ora";
@@ -1061,17 +1037,36 @@ export const {
 } = authClient
 `;
   await writeFile(path3.join(appDir, "src/lib/auth.ts"), authClientContent);
-  const convexContent = `import { ConvexProvider, ConvexReactClient } from 'convex/react'
+  const convexContent = `'use client'
+
+import { ConvexProvider, ConvexReactClient } from 'convex/react'
 import { env } from '@/env'
 
 const convexUrl = env.NEXT_PUBLIC_CONVEX_URL
-if (!convexUrl) {
-  throw new Error(
-    'NEXT_PUBLIC_CONVEX_URL is not set. Run "npx convex dev" to set up Convex.'
-  )
-}
 
-export const convex = new ConvexReactClient(convexUrl)
+// Create client only if URL is available
+export const convex = convexUrl ? new ConvexReactClient(convexUrl) : null
+
+// Wrapper provider that handles missing Convex configuration
+export function ConvexClientProvider({ children }: { children: React.ReactNode }) {
+  if (!convex) {
+    return (
+      <div className="min-h-screen flex items-center justify-center bg-background">
+        <div className="text-center p-8 max-w-md">
+          <h1 className="text-2xl font-bold mb-4">Convex Not Configured</h1>
+          <p className="text-muted-foreground mb-4">
+            Run <code className="bg-muted px-2 py-1 rounded">npx convex dev</code> in your terminal to set up Convex.
+          </p>
+          <p className="text-sm text-muted-foreground">
+            This will create your Convex project and add the required environment variables.
+          </p>
+        </div>
+      </div>
+    )
+  }
+
+  return <ConvexProvider client={convex}>{children}</ConvexProvider>
+}
 
 export { ConvexProvider }
 `;
@@ -1198,15 +1193,14 @@ export const env = createEnv({
 async function generateComponentFiles(config, appDir) {
   let providersContent = `'use client'
 
-import { ConvexProvider } from '@/lib/convex'
-import { convex } from '@/lib/convex'`;
+import { ConvexClientProvider } from '@/lib/convex'`;
   if (config.integrations.analytics === "posthog") {
     providersContent += `
 import posthog from 'posthog-js'
 import { PostHogProvider } from 'posthog-js/react'
 import { env } from '@/env'
 
-if (typeof window !== 'undefined') {
+if (typeof window !== 'undefined' && env.NEXT_PUBLIC_POSTHOG_KEY) {
   posthog.init(env.NEXT_PUBLIC_POSTHOG_KEY, {
     api_host: env.NEXT_PUBLIC_POSTHOG_HOST,
     person_profiles: 'identified_only',
@@ -1222,9 +1216,9 @@ export function Providers({ children }: { children: React.ReactNode }) {
     <PostHogProvider client={posthog}>`;
   }
   providersContent += `
-      <ConvexProvider client={convex}>
+      <ConvexClientProvider>
         {children}
-      </ConvexProvider>`;
+      </ConvexClientProvider>`;
   if (config.integrations.analytics === "posthog") {
     providersContent += `
     </PostHogProvider>`;
@@ -2059,18 +2053,19 @@ import { ConvexHttpClient } from 'convex/browser'
 import { env } from '@/env'
 
 const convexUrl = env.NEXT_PUBLIC_CONVEX_URL
-if (!convexUrl) {
-  throw new Error(
-    'NEXT_PUBLIC_CONVEX_URL is not set. Run "npx convex dev" to set up Convex.'
-  )
-}
 
-const convex = new ConvexHttpClient(convexUrl)
+// Auth is only functional when Convex is configured
+const convex = convexUrl ? new ConvexHttpClient(convexUrl) : null
+
+function createAuth() {
+  if (!convex) {
+    throw new Error('NEXT_PUBLIC_CONVEX_URL is not set. Run "npx convex dev" to set up Convex.')
+  }
 
-export const auth = betterAuth({
-  database: convexAdapter(convex),
-  secret: env.BETTER_AUTH_SECRET || '',
-  baseURL: env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
+  return betterAuth({
+    database: convexAdapter(convex),
+    secret: env.BETTER_AUTH_SECRET || '',
+    baseURL: env.NEXT_PUBLIC_APP_URL || 'http://localhost:3000',
   emailAndPassword: {
     enabled: true,
     sendResetPassword: async ({ user, url }) => {
@@ -2100,7 +2095,11 @@ export const auth = betterAuth({
   ],`;
   }
   content += `
-})
+  })
+}
+
+// Lazy initialization - only create auth when needed
+export const auth = convex ? createAuth() : null
 `;
   await writeFile(path7.join(appDir, "src/lib/auth-server.ts"), content);
 }
@@ -2769,19 +2768,18 @@ async function generateRateLimiting(config, appDir) {
   }
 }
 async function generateArcjet(appDir) {
-  const content = `import arcjet, { shield, rateLimit, detectBot } from '@arcjet/next'
+  const content = `import arcjet, { shield, fixedWindow, detectBot } from '@arcjet/next'
 import { env } from '@/env'
 
 export const aj = arcjet({
-  key: env.ARCJET_KEY,
-  characteristics: ['ip.src'],
+  key: env.ARCJET_KEY!,
   rules: [
     // Shield protects against common attacks
     shield({ mode: 'LIVE' }),
-    // Rate limit API requests
-    rateLimit({
+    // Rate limit API requests - 100 requests per minute
+    fixedWindow({
       mode: 'LIVE',
-      interval: '1m',
+      window: '1m',
       max: 100,
     }),
     // Bot detection
@@ -4270,517 +4268,8 @@ S3_ENDPOINT="https://[PROJECT].supabase.co/storage/v1/s3"
   await writeFile(path15.join(marketingDir, ".env.local"), envContent);
 }
 
-// src/generators/fumadocs.ts
-import path16 from "path";
-async function generateFumadocs(config, docsDir) {
-  await ensureDir(path16.join(docsDir, "content/docs"));
-  await ensureDir(path16.join(docsDir, "src/app/docs/[[...slug]]"));
-  await ensureDir(path16.join(docsDir, "src/lib"));
-  await generateFumadocsPackageJson(docsDir);
-  await generateFumadocsNextConfig(docsDir);
-  await generateFumadocsTsConfig(docsDir);
-  await generateFumadocsSource(docsDir);
-  await generateFumadocsAppFiles(config, docsDir);
-  await generateFumadocsContent(config, docsDir);
-}
-async function generateFumadocsPackageJson(docsDir) {
-  const packageJson2 = {
-    name: "@repo/docs",
-    version: "0.1.0",
-    private: true,
-    scripts: {
-      dev: "next dev --turbopack -p 3002",
-      build: "next build",
-      start: "next start",
-      lint: "biome check .",
-      "lint:fix": "biome check --write .",
-      typecheck: "tsc --noEmit"
-    },
-    dependencies: {
-      next: "^16.0.0",
-      react: "^19.0.0",
-      "react-dom": "^19.0.0",
-      "fumadocs-core": "^16.0.0",
-      "fumadocs-mdx": "^14.0.0",
-      "fumadocs-ui": "^16.0.0",
-      "@repo/ui": "workspace:*"
-    },
-    devDependencies: {
-      "@repo/config-typescript": "workspace:*",
-      "@types/node": "^20.0.0",
-      "@types/react": "^19.0.0",
-      "@types/react-dom": "^19.0.0",
-      "@types/mdx": "^2.0.0",
-      tailwindcss: "^4.0.0",
-      "@tailwindcss/postcss": "^4.0.0",
-      postcss: "^8.4.0",
-      typescript: "^5.0.0"
-    }
-  };
-  await writeJSON(path16.join(docsDir, "package.json"), packageJson2);
-}
-async function generateFumadocsNextConfig(docsDir) {
-  const content = `import { createMDX } from 'fumadocs-mdx/next'
-import type { NextConfig } from 'next'
-
-const withMDX = createMDX()
-
-const config: NextConfig = {
-  reactStrictMode: true,
-  transpilePackages: ['@repo/ui'],
-}
-
-export default withMDX(config)
-`;
-  await writeFile(path16.join(docsDir, "next.config.ts"), content);
-}
-async function generateFumadocsTsConfig(docsDir) {
-  const tsConfig = {
-    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: "preserve",
-      incremental: true,
-      plugins: [{ name: "next" }],
-      paths: {
-        "@/*": ["./src/*"],
-        "fumadocs-mdx:collections/*": ["./.source/*"]
-      }
-    },
-    include: [
-      "next-env.d.ts",
-      "**/*.ts",
-      "**/*.tsx",
-      "**/*.mdx",
-      ".next/types/**/*.ts",
-      ".source/**/*.ts"
-    ],
-    exclude: ["node_modules"]
-  };
-  await writeJSON(path16.join(docsDir, "tsconfig.json"), tsConfig);
-}
-async function generateFumadocsSource(docsDir) {
-  const content = `import { docs } from 'fumadocs-mdx:collections/server'
-import { loader } from 'fumadocs-core/source'
-
-export const source = loader({
-  baseUrl: '/docs',
-  source: docs.toFumadocsSource(),
-})
-`;
-  await writeFile(path16.join(docsDir, "src/lib/source.ts"), content);
-}
-async function generateFumadocsAppFiles(config, docsDir) {
-  const layoutContent = `import { RootProvider } from 'fumadocs-ui/provider/next'
-import { Inter } from 'next/font/google'
-import type { Metadata } from 'next'
-import type { ReactNode } from 'react'
-import './global.css'
-
-const inter = Inter({
-  subsets: ['latin'],
-})
-
-export const metadata: Metadata = {
-  title: {
-    template: '%s | ${config.name} Docs',
-    default: '${config.name} Documentation',
-  },
-  description: 'Documentation for ${config.name}',
-}
-
-export default function RootLayout({ children }: { children: ReactNode }) {
-  return (
-    <html lang="en" className={inter.className} suppressHydrationWarning>
-      <body className="flex flex-col min-h-screen">
-        <RootProvider>{children}</RootProvider>
-      </body>
-    </html>
-  )
-}
-`;
-  await writeFile(path16.join(docsDir, "src/app/layout.tsx"), layoutContent);
-  const docsLayoutContent = `import { DocsLayout } from 'fumadocs-ui/layouts/docs'
-import type { ReactNode } from 'react'
-import { source } from '@/lib/source'
-
-export default function Layout({ children }: { children: ReactNode }) {
-  return (
-    <DocsLayout
-      tree={source.pageTree}
-      nav={{
-        title: '${config.name} Docs',
-      }}
-    >
-      {children}
-    </DocsLayout>
-  )
-}
-`;
-  await writeFile(
-    path16.join(docsDir, "src/app/docs/layout.tsx"),
-    docsLayoutContent
-  );
-  const docsPageContent = `import { source } from '@/lib/source'
-import {
-  DocsPage,
-  DocsBody,
-  DocsDescription,
-  DocsTitle,
-} from 'fumadocs-ui/page'
-import { notFound } from 'next/navigation'
-import defaultMdxComponents from 'fumadocs-ui/mdx'
-
-export default async function Page(props: {
-  params: Promise<{ slug?: string[] }>
-}) {
-  const params = await props.params
-  const page = source.getPage(params.slug)
-  if (!page) notFound()
-
-  const MDX = page.data.body
-
-  return (
-    <DocsPage toc={page.data.toc} full={page.data.full}>
-      <DocsTitle>{page.data.title}</DocsTitle>
-      <DocsDescription>{page.data.description}</DocsDescription>
-      <DocsBody>
-        <MDX components={{ ...defaultMdxComponents }} />
-      </DocsBody>
-    </DocsPage>
-  )
-}
-
-export async function generateStaticParams() {
-  return source.generateParams()
-}
-
-export async function generateMetadata(props: {
-  params: Promise<{ slug?: string[] }>
-}) {
-  const params = await props.params
-  const page = source.getPage(params.slug)
-  if (!page) notFound()
-
-  return {
-    title: page.data.title,
-    description: page.data.description,
-  }
-}
-`;
-  await writeFile(
-    path16.join(docsDir, "src/app/docs/[[...slug]]/page.tsx"),
-    docsPageContent
-  );
-  const homePageContent = `import { redirect } from 'next/navigation'
-
-export default function HomePage() {
-  redirect('/docs')
-}
-`;
-  await writeFile(path16.join(docsDir, "src/app/page.tsx"), homePageContent);
-  const globalCssContent = `@import 'tailwindcss';
-@import 'fumadocs-ui/css/neutral.css';
-@import 'fumadocs-ui/css/preset.css';
-
-@source '../node_modules/fumadocs-ui/dist/**/*.js';
-`;
-  await writeFile(path16.join(docsDir, "src/app/global.css"), globalCssContent);
-  const sourceConfigContent = `import { defineDocs, defineConfig } from 'fumadocs-mdx/config'
-
-export const { docs, meta } = defineDocs({
-  dir: 'content/docs',
-})
-
-export default defineConfig()
-`;
-  await writeFile(path16.join(docsDir, "source.config.ts"), sourceConfigContent);
-  const postcssContent = `export default {
-  plugins: {
-    '@tailwindcss/postcss': {},
-  },
-}
-`;
-  await writeFile(path16.join(docsDir, "postcss.config.mjs"), postcssContent);
-}
-async function generateFumadocsContent(config, docsDir) {
-  const metaJson = {
-    title: "Documentation",
-    pages: ["index", "getting-started", "---", "guides", "api"]
-  };
-  await writeJSON(path16.join(docsDir, "content/docs/meta.json"), metaJson);
-  const indexContent = `---
-title: Introduction
-description: Welcome to ${config.name} documentation
----
-
-# Welcome to ${config.name}
-
-This is the documentation for ${config.name}, built with [Fumadocs](https://fumadocs.vercel.app).
-
-## Features
-
-- Built with Next.js 15 and React 19
-- Convex for real-time database
-- Better-Auth for authentication
-- shadcn/ui components
-- Tailwind CSS v4
-
-## Getting Started
-
-Check out the [Getting Started](/docs/getting-started) guide to begin.
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/index.mdx"),
-    indexContent
-  );
-  const gettingStartedContent = `---
-title: Getting Started
-description: Get started with ${config.name}
----
-
-# Getting Started
-
-This guide will help you get ${config.name} up and running.
-
-## Prerequisites
-
-- Node.js 18 or higher
-- pnpm package manager
-
-## Installation
-
-1. Clone the repository
-2. Install dependencies:
-
-\`\`\`bash
-pnpm install
-\`\`\`
-
-3. Copy environment variables:
-
-\`\`\`bash
-cp .env.example .env.local
-\`\`\`
-
-4. Set up Convex:
-
-\`\`\`bash
-pnpm convex dev
-\`\`\`
-
-5. Start the development server:
-
-\`\`\`bash
-pnpm dev
-\`\`\`
-
-## Next Steps
-
-- [Configure authentication](/docs/guides/authentication)
-- [Set up your database schema](/docs/guides/database)
-- [Customize the UI](/docs/guides/customization)
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/getting-started.mdx"),
-    gettingStartedContent
-  );
-  await ensureDir(path16.join(docsDir, "content/docs/guides"));
-  const guidesMetaJson = {
-    title: "Guides",
-    pages: ["authentication", "database", "customization"]
-  };
-  await writeJSON(
-    path16.join(docsDir, "content/docs/guides/meta.json"),
-    guidesMetaJson
-  );
-  const authGuideContent = `---
-title: Authentication
-description: Learn how to configure authentication in ${config.name}
----
-
-# Authentication
-
-${config.name} uses Better-Auth with Convex for authentication.
-
-## Supported Providers
-
-- Email/Password (always enabled)
-- Google OAuth (always enabled)
-${config.auth.providers.map((p8) => `- ${p8.charAt(0).toUpperCase() + p8.slice(1)}`).join("\n")}
-
-## Configuration
-
-Authentication is configured in \`convex/auth.ts\`.
-
-\`\`\`typescript
-export const { auth, createAuth } = new BetterAuth<DataModel>(components.betterAuth, {
-  emailAndPassword: {
-    enabled: true,
-  },
-  socialProviders: {
-    google: {
-      clientId: process.env.GOOGLE_CLIENT_ID!,
-      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
-    },
-  },
-})
-\`\`\`
-
-## Using Authentication
-
-Use the auth client in your components:
-
-\`\`\`typescript
-import { signIn, signOut, useSession } from '@/lib/auth'
-
-// Sign in
-await signIn.email({ email, password })
-
-// Sign out
-await signOut()
-
-// Get session
-const { data: session } = useSession()
-\`\`\`
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/guides/authentication.mdx"),
-    authGuideContent
-  );
-  const databaseGuideContent = `---
-title: Database
-description: Working with Convex database
----
-
-# Database
-
-${config.name} uses Convex as its database.
-
-## Schema
-
-The database schema is defined in \`convex/schema.ts\`.
-
-## Queries
-
-Create queries to read data:
-
-\`\`\`typescript
-import { query } from './_generated/server'
-
-export const getUsers = query({
-  handler: async (ctx) => {
-    return await ctx.db.query('users').collect()
-  },
-})
-\`\`\`
-
-## Mutations
-
-Create mutations to write data:
-
-\`\`\`typescript
-import { mutation } from './_generated/server'
-import { v } from 'convex/values'
-
-export const createUser = mutation({
-  args: {
-    name: v.string(),
-    email: v.string(),
-  },
-  handler: async (ctx, args) => {
-    return await ctx.db.insert('users', args)
-  },
-})
-\`\`\`
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/guides/database.mdx"),
-    databaseGuideContent
-  );
-  const customizationGuideContent = `---
-title: Customization
-description: Customize the look and feel of ${config.name}
----
-
-# Customization
-
-## Theme
-
-The theme is configured in \`src/app/globals.css\` using Tailwind CSS v4.
-
-### Colors
-
-Update the theme colors in the CSS:
-
-\`\`\`css
-@theme {
-  --color-primary: oklch(0.6 0.2 250);
-  --color-primary-foreground: oklch(0.98 0 0);
-}
-\`\`\`
-
-### Dark Mode
-
-Dark mode is supported out of the box. Define dark mode styles with:
-
-\`\`\`css
-.dark {
-  --color-background: oklch(0.145 0 0);
-}
-\`\`\`
-
-## Components
-
-UI components are in \`src/components/ui\`. Customize or add new components as needed.
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/guides/customization.mdx"),
-    customizationGuideContent
-  );
-  await ensureDir(path16.join(docsDir, "content/docs/api"));
-  const apiMetaJson = {
-    title: "API Reference",
-    pages: ["overview"]
-  };
-  await writeJSON(
-    path16.join(docsDir, "content/docs/api/meta.json"),
-    apiMetaJson
-  );
-  const apiOverviewContent = `---
-title: API Overview
-description: API reference for ${config.name}
----
-
-# API Reference
-
-This section contains the API reference for ${config.name}.
-
-## Authentication API
-
-See the [Better-Auth documentation](https://www.better-auth.com) for detailed API reference.
-
-## Database API
-
-See the [Convex documentation](https://docs.convex.dev) for database API reference.
-`;
-  await writeFile(
-    path16.join(docsDir, "content/docs/api/overview.mdx"),
-    apiOverviewContent
-  );
-}
-
 // src/generators/design-system.ts
-import path17 from "path";
+import path16 from "path";
 var fontImports = {
   inter: {
     import: "import { Inter } from 'next/font/google'",
@@ -4848,17 +4337,17 @@ var spacingMultipliers = {
   relaxed: 1.125
 };
 async function generateDesignSystemApp(config, targetDir) {
-  const appDir = path17.join(targetDir, "apps/design-system");
-  await ensureDir(path17.join(appDir, "src/app"));
-  await ensureDir(path17.join(appDir, "src/app/colors"));
-  await ensureDir(path17.join(appDir, "src/app/typography"));
-  await ensureDir(path17.join(appDir, "src/app/spacing"));
-  await ensureDir(path17.join(appDir, "src/app/brand"));
-  await ensureDir(path17.join(appDir, "src/app/blocks"));
-  await ensureDir(path17.join(appDir, "src/app/components"));
-  await ensureDir(path17.join(appDir, "src/app/components/[slug]"));
-  await ensureDir(path17.join(appDir, "src/lib"));
-  await ensureDir(path17.join(appDir, "public/brand"));
+  const appDir = path16.join(targetDir, "apps/design-system");
+  await ensureDir(path16.join(appDir, "src/app"));
+  await ensureDir(path16.join(appDir, "src/app/colors"));
+  await ensureDir(path16.join(appDir, "src/app/typography"));
+  await ensureDir(path16.join(appDir, "src/app/spacing"));
+  await ensureDir(path16.join(appDir, "src/app/brand"));
+  await ensureDir(path16.join(appDir, "src/app/blocks"));
+  await ensureDir(path16.join(appDir, "src/app/components"));
+  await ensureDir(path16.join(appDir, "src/app/components/[slug]"));
+  await ensureDir(path16.join(appDir, "src/lib"));
+  await ensureDir(path16.join(appDir, "public/brand"));
   await generatePackageJson2(config, appDir);
   await generateTsConfig2(appDir);
   await generateNextConfig2(appDir);
@@ -4911,7 +4400,7 @@ async function generatePackageJson2(config, appDir) {
       typescript: "^5.0.0"
     }
   };
-  await writeJSON(path17.join(appDir, "package.json"), packageJson2);
+  await writeJSON(path16.join(appDir, "package.json"), packageJson2);
 }
 async function generateTsConfig2(appDir) {
   const tsConfig = {
@@ -4939,7 +4428,7 @@ async function generateTsConfig2(appDir) {
     include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
     exclude: ["node_modules"]
   };
-  await writeJSON(path17.join(appDir, "tsconfig.json"), tsConfig);
+  await writeJSON(path16.join(appDir, "tsconfig.json"), tsConfig);
 }
 async function generateNextConfig2(appDir) {
   const content = `import type { NextConfig } from 'next'
@@ -4950,7 +4439,7 @@ const nextConfig: NextConfig = {
 
 export default nextConfig
 `;
-  await writeFile(path17.join(appDir, "next.config.ts"), content);
+  await writeFile(path16.join(appDir, "next.config.ts"), content);
 }
 async function generatePostCssConfig2(appDir) {
   const content = `export default {
@@ -4959,7 +4448,7 @@ async function generatePostCssConfig2(appDir) {
   },
 }
 `;
-  await writeFile(path17.join(appDir, "postcss.config.mjs"), content);
+  await writeFile(path16.join(appDir, "postcss.config.mjs"), content);
 }
 async function generateGlobalsCss2(config, appDir) {
   const { designSystem } = config;
@@ -5219,7 +4708,7 @@ h1, h2, h3, h4, h5, h6 {
   }
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/globals.css"), content);
+  await writeFile(path16.join(appDir, "src/app/globals.css"), content);
 }
 async function generateLayoutTsx(config, appDir) {
   const { designSystem } = config;
@@ -5418,7 +4907,7 @@ function ThemeToggle() {
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/layout.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/layout.tsx"), content);
 }
 async function generateHomePage(config, appDir) {
   const content = `export default function DesignSystemHome() {
@@ -5584,7 +5073,7 @@ function Principle({
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/page.tsx"), content);
 }
 async function generateColorsPage(config, appDir) {
   const content = `export default function ColorsPage() {
@@ -5753,7 +5242,7 @@ function ColorCard({
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/colors/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/colors/page.tsx"), content);
 }
 async function generateTypographyPage(config, appDir) {
   const { designSystem } = config;
@@ -5910,7 +5399,7 @@ function WeightCard({ weight, name }: { weight: string; name: string }) {
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/typography/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/typography/page.tsx"), content);
 }
 async function generateSpacingPage(config, appDir) {
   const { designSystem } = config;
@@ -6043,7 +5532,7 @@ function PatternCard({
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/spacing/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/spacing/page.tsx"), content);
 }
 async function generateBrandPage(config, appDir) {
   const content = `export default function BrandPage() {
@@ -6181,7 +5670,7 @@ function DownloadCard({
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/brand/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/brand/page.tsx"), content);
 }
 async function generateBlocksPage(appDir) {
   const content = `export default function BlocksPage() {
@@ -6243,7 +5732,7 @@ function BlockCard({ title, description }: { title: string; description: string
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/blocks/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/blocks/page.tsx"), content);
 }
 async function generateComponentsPage(appDir) {
   const content = `export default function ComponentsPage() {
@@ -6323,7 +5812,7 @@ function CategoryCard({
   )
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/components/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/components/page.tsx"), content);
 }
 async function generateComponentSlugPage(appDir) {
   const content = `import { notFound } from 'next/navigation'
@@ -6427,7 +5916,7 @@ export function generateStaticParams() {
   return components.map((slug) => ({ slug }))
 }
 `;
-  await writeFile(path17.join(appDir, "src/app/components/[slug]/page.tsx"), content);
+  await writeFile(path16.join(appDir, "src/app/components/[slug]/page.tsx"), content);
 }
 async function generateUtils(appDir) {
   const content = `import { clsx, type ClassValue } from 'clsx'
@@ -6437,7 +5926,7 @@ export function cn(...inputs: ClassValue[]) {
   return twMerge(clsx(inputs))
 }
 `;
-  await writeFile(path17.join(appDir, "src/lib/utils.ts"), content);
+  await writeFile(path16.join(appDir, "src/lib/utils.ts"), content);
 }
 
 // src/setup/env-wizard.ts
@@ -6445,7 +5934,7 @@ import * as p6 from "@clack/prompts";
 import pc2 from "picocolors";
 import { exec } from "child_process";
 import { promisify } from "util";
-import path18 from "path";
+import path17 from "path";
 var execAsync = promisify(exec);
 async function runEnvSetupWizard(config) {
   console.log();
@@ -6526,7 +6015,7 @@ This will open your browser to create a new project on Convex.
 ${pc2.dim("Note: Make sure you have a Convex account at https://convex.dev")}
 `);
     try {
-      const convexDir = config.structure === "monorepo" ? path18.join(config.targetDir, "packages/backend") : config.targetDir;
+      const convexDir = config.structure === "monorepo" ? path17.join(config.targetDir, "packages/backend") : config.targetDir;
       const { spawn } = await import("child_process");
       p6.log.info(`Installing dependencies in ${pc2.dim(convexDir)}...`);
       const installSuccess = await new Promise((resolve) => {
@@ -6802,7 +6291,7 @@ async function writeEnvFiles(config, envValues) {
     return;
   }
   p6.log.step("Writing environment files...");
-  const webEnvPath = config.structure === "monorepo" ? path18.join(config.targetDir, "apps/web/.env.local") : path18.join(config.targetDir, ".env.local");
+  const webEnvPath = config.structure === "monorepo" ? path17.join(config.targetDir, "apps/web/.env.local") : path17.join(config.targetDir, ".env.local");
   if (await pathExists(webEnvPath)) {
     let content = await readFile(webEnvPath);
     for (const [key, value] of Object.entries(envValues)) {
@@ -6821,7 +6310,7 @@ ${key}="${value}"`;
     p6.log.success(`Updated ${config.structure === "monorepo" ? "apps/web/.env.local" : ".env.local"}`);
   }
   if (config.marketingSite === "payload" && config.structure === "monorepo") {
-    const marketingEnvPath = path18.join(config.targetDir, "apps/marketing/.env.local");
+    const marketingEnvPath = path17.join(config.targetDir, "apps/marketing/.env.local");
     if (await pathExists(marketingEnvPath)) {
       let content = await readFile(marketingEnvPath);
       const payloadEnvKeys = ["PAYLOAD_SECRET", "DATABASE_URL", "S3_ENDPOINT", "S3_REGION", "S3_BUCKET", "S3_ACCESS_KEY_ID", "S3_SECRET_ACCESS_KEY", "CRON_SECRET", "PREVIEW_SECRET"];
@@ -6882,7 +6371,7 @@ async function generateSingleProject(config, spinner) {
   await generateShadcn(config, targetDir);
   spinner.succeed("shadcn/ui configured");
   spinner.start("Setting up Convex...");
-  await generateConvex(config, path19.join(targetDir, "convex"));
+  await generateConvex(config, path18.join(targetDir, "convex"));
   spinner.succeed("Convex configured");
   spinner.start("Configuring Better-Auth...");
   await generateBetterAuth(config, targetDir);
@@ -6925,7 +6414,7 @@ async function generateMonorepoProject(config, spinner) {
   spinner.start("Creating shared UI package...");
   await generateUIPackage(config, targetDir);
   spinner.succeed("Shared UI package created");
-  const webDir = path19.join(targetDir, "apps/web");
+  const webDir = path18.join(targetDir, "apps/web");
   spinner.start("Generating web application...");
   await generateBaseNextjs(config, webDir);
   await generateTailwind(config, webDir);
@@ -6935,10 +6424,10 @@ async function generateMonorepoProject(config, spinner) {
   await generateEmail(config, webDir);
   await updateWebTsConfig(webDir);
   spinner.succeed("Web application generated");
-  const backendDir = path19.join(targetDir, "packages/backend");
+  const backendDir = path18.join(targetDir, "packages/backend");
   spinner.start("Setting up Convex backend...");
   await ensureDir(backendDir);
-  await generateConvex(config, path19.join(backendDir, "convex"));
+  await generateConvex(config, path18.join(backendDir, "convex"));
   spinner.succeed("Convex backend configured");
   if (config.integrations.analytics !== "none") {
     spinner.start(`Setting up ${config.integrations.analytics} analytics...`);
@@ -6961,7 +6450,7 @@ async function generateMonorepoProject(config, spinner) {
     spinner.succeed(`${config.integrations.monitoring} monitoring configured`);
   }
   if (config.marketingSite !== "none") {
-    const marketingDir = path19.join(targetDir, "apps/marketing");
+    const marketingDir = path18.join(targetDir, "apps/marketing");
     spinner.start(`Generating ${config.marketingSite} marketing site...`);
     if (config.marketingSite === "payload") {
       await generatePayload(config, marketingDir);
@@ -6970,12 +6459,6 @@ async function generateMonorepoProject(config, spinner) {
     }
     spinner.succeed(`${config.marketingSite} marketing site generated`);
   }
-  if (config.includeDocs) {
-    const docsDir = path19.join(targetDir, "apps/docs");
-    spinner.start("Generating Fumadocs documentation site...");
-    await generateFumadocs(config, docsDir);
-    spinner.succeed("Fumadocs documentation site generated");
-  }
   spinner.start("Generating design system app...");
   await generateDesignSystemApp(config, targetDir);
   spinner.succeed("Design system app generated");
@@ -6992,7 +6475,7 @@ async function runPostGenerationSteps(config, spinner) {
   }
   spinner.start("Installing shadcn/ui components...");
   try {
-    const shadcnDir = config.structure === "monorepo" ? path19.join(targetDir, "packages/ui") : targetDir;
+    const shadcnDir = config.structure === "monorepo" ? path18.join(targetDir, "packages/ui") : targetDir;
     await runShadcnAdd(shadcnDir);
     spinner.succeed("shadcn/ui components installed");
   } catch (error) {
@@ -7052,7 +6535,7 @@ async function generateBiomeConfig(targetDir) {
     }
   };
   await writeFile(
-    path19.join(targetDir, "biome.json"),
+    path18.join(targetDir, "biome.json"),
     JSON.stringify(biomeJson, null, 2)
   );
 }
@@ -7103,13 +6586,13 @@ yarn-error.log*
 *.pem
 .cache
 `;
-  await writeFile(path19.join(targetDir, ".gitignore"), gitignoreContent);
+  await writeFile(path18.join(targetDir, ".gitignore"), gitignoreContent);
 }
 async function generateHuskyHooks(targetDir) {
   const preCommitContent = `pnpm lint-staged
 `;
-  await ensureDir(path19.join(targetDir, ".husky"));
-  await writeFile(path19.join(targetDir, ".husky/pre-commit"), preCommitContent);
+  await ensureDir(path18.join(targetDir, ".husky"));
+  await writeFile(path18.join(targetDir, ".husky/pre-commit"), preCommitContent);
 }
 async function updateWebTsConfig(webDir) {
   const tsConfig = {
@@ -7136,14 +6619,14 @@ async function updateWebTsConfig(webDir) {
     exclude: ["node_modules"]
   };
   await writeFile(
-    path19.join(webDir, "tsconfig.json"),
+    path18.join(webDir, "tsconfig.json"),
     JSON.stringify(tsConfig, null, 2)
   );
 }
 async function generateNextjsMarketing(config, marketingDir) {
-  await ensureDir(path19.join(marketingDir, "src/app"));
-  await ensureDir(path19.join(marketingDir, "src/components"));
-  await ensureDir(path19.join(marketingDir, "public"));
+  await ensureDir(path18.join(marketingDir, "src/app"));
+  await ensureDir(path18.join(marketingDir, "src/components"));
+  await ensureDir(path18.join(marketingDir, "public"));
   const packageJson2 = {
     name: "@repo/marketing",
     version: "0.1.0",
@@ -7174,7 +6657,7 @@ async function generateNextjsMarketing(config, marketingDir) {
     }
   };
   await writeFile(
-    path19.join(marketingDir, "package.json"),
+    path18.join(marketingDir, "package.json"),
     JSON.stringify(packageJson2, null, 2)
   );
   const homePageContent = `export default function HomePage() {
@@ -7197,7 +6680,7 @@ async function generateNextjsMarketing(config, marketingDir) {
 }
 `;
   await writeFile(
-    path19.join(marketingDir, "src/app/page.tsx"),
+    path18.join(marketingDir, "src/app/page.tsx"),
     homePageContent
   );
   const layoutContent = `import type { Metadata } from 'next'
@@ -7221,7 +6704,7 @@ export default function RootLayout({
 }
 `;
   await writeFile(
-    path19.join(marketingDir, "src/app/layout.tsx"),
+    path18.join(marketingDir, "src/app/layout.tsx"),
     layoutContent
   );
   const globalsCss = `@import "tailwindcss";
@@ -7233,7 +6716,7 @@ export default function RootLayout({
 }
 `;
   await writeFile(
-    path19.join(marketingDir, "src/app/globals.css"),
+    path18.join(marketingDir, "src/app/globals.css"),
     globalsCss
   );
   const tsConfig = {
@@ -7260,7 +6743,7 @@ export default function RootLayout({
     exclude: ["node_modules"]
   };
   await writeFile(
-    path19.join(marketingDir, "tsconfig.json"),
+    path18.join(marketingDir, "tsconfig.json"),
     JSON.stringify(tsConfig, null, 2)
   );
   const nextConfig = `import type { NextConfig } from 'next'
@@ -7271,14 +6754,14 @@ const nextConfig: NextConfig = {
 
 export default nextConfig
 `;
-  await writeFile(path19.join(marketingDir, "next.config.ts"), nextConfig);
+  await writeFile(path18.join(marketingDir, "next.config.ts"), nextConfig);
   const postcssConfig = `export default {
   plugins: {
     '@tailwindcss/postcss': {},
   },
 }
 `;
-  await writeFile(path19.join(marketingDir, "postcss.config.mjs"), postcssConfig);
+  await writeFile(path18.join(marketingDir, "postcss.config.mjs"), postcssConfig);
 }
 function displaySuccessMessage(config) {
   const apps = ["web"];
@@ -7286,9 +6769,6 @@ function displaySuccessMessage(config) {
     if (config.marketingSite !== "none") {
       apps.push("marketing");
     }
-    if (config.includeDocs) {
-      apps.push("docs");
-    }
     apps.push("design-system");
   }
   console.log();
@@ -7321,9 +6801,6 @@ function displaySuccessMessage(config) {
   if (config.marketingSite === "payload") {
     console.log(`  ${pc3.dim("-")} Payload CMS: ${pc3.cyan("https://payloadcms.com/docs")}`);
   }
-  if (config.includeDocs) {
-    console.log(`  ${pc3.dim("-")} Fumadocs: ${pc3.cyan("https://fumadocs.vercel.app")}`);
-  }
   console.log();
 }
 
@@ -7351,7 +6828,7 @@ program.name("create-kofi-stack").description(
 ).version(packageJson.version).argument("[project-name]", "Name of the project").option("--monorepo", "Use monorepo structure with Turborepo").option("--single", "Use single app structure").option(
   "--marketing <type>",
   "Marketing site type: payload, nextjs, none"
-).option("--docs", "Include documentation site (Fumadocs)").option("--no-docs", "Exclude documentation site").option(
+).option(
   "--component-library <library>",
   "Component library: base (Base UI), radix (Radix UI)"
 ).option(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kofi-stack",
-  "version": "1.2.18",
+  "version": "1.2.20",
   "description": "Scaffold opinionated full-stack projects with Next.js, Convex, Better-Auth, and more",
   "type": "module",
   "bin": {