create-lumen 2.0.0-beta.1 → 2.0.0-beta.3

package/src/manifest/schema.js

@@ -13,7 +13,7 @@ export const FRAMEWORK_BUNDLERS = ["turbopack", "webpack"];
 export const FRAMEWORK_ADAPTERS = ["node", "vercel", "cloudflare", "static"];
 
 export const STYLING_ENGINES = ["tailwind", "none"];
-export const ARCHITECTURE_PRESETS = ["feature-based", "type-based", "hybrid", "none"];
+export const ARCHITECTURE_PRESETS = ["feature-based", "type-based", "none"];
 // Legacy alias: docs used architecture.type, canonical is architecture.preset.
 // Keep both in sync; parseManifest normalizes to expose both keys.
 export const ARCHITECTURE_TYPES = ARCHITECTURE_PRESETS;
@@ -23,6 +23,8 @@ export const DOCS_LANGUAGES = ["en", "es"];
 export const TOOLING_LANGUAGES = ["ts", "js"];
 export const TOOLING_LINTERS = ["eslint", "oxlint", "biome", "none"];
 export const TOOLING_FORMATTERS = ["prettier", "oxfmt", "none"];
+export const DATABASE_ORMS = ["prisma", "none"];
+export const DATABASE_PROVIDERS = ["postgresql", "supabase"];
 
 // ---------------------------------------------------------------------------
 // Sub-schemas
@@ -121,6 +123,13 @@ const toolingSchema = z
   })
   .strict();
 
+const databaseSchema = z
+  .object({
+    orm: z.enum(DATABASE_ORMS),
+    provider: z.enum(DATABASE_PROVIDERS).optional().default("postgresql"),
+  })
+  .strict();
+
 // ---------------------------------------------------------------------------
 // Top-level manifest v2 - strict, no extra keys except $schema
 // ---------------------------------------------------------------------------
@@ -136,6 +145,9 @@ export const manifestSchemaV2 = z
     docs: docsSchema,
     paths: pathsSchema,
     tooling: toolingSchema,
+    database: databaseSchema.optional(),
+    docker: z.boolean().optional(),
+    routeGroups: z.boolean().optional(),
     reactCompiler: z.boolean().optional(),
     agentDocs: z.boolean().optional(),
   })
@@ -177,12 +189,30 @@ export const manifestSchemaV2 = z
       });
     }
 
+    // database only for Next.js (#62)
+    if (val.database !== undefined && val.database.orm !== "none" && framework.name !== "next") {
+      ctx.addIssue({
+        code: "custom",
+        path: ["database", "orm"],
+        message: `database is only valid when framework.name is "next"`,
+      });
+    }
+
+    // routeGroups only for Next.js App Router (#64)
+    if (val.routeGroups === true && (framework.name !== "next" || framework.variant !== "app-router")) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["routeGroups"],
+        message: `routeGroups is only valid when framework is "next:app-router"`,
+      });
+    }
+
     // architecture scoping per framework (#34) — canonical `preset`, legacy `type` fallback
     const archValue = architecture.preset ?? architecture.type;
     const allowedByFramework =
       framework.name === "react"
         ? ["feature-based", "type-based", "none"]
-        : ["feature-based", "hybrid", "none"];
+        : ["feature-based", "none"];
     if (!allowedByFramework.includes(archValue)) {
       ctx.addIssue({
         code: "custom",

package/src/prompts.js

@@ -1,4 +1,4 @@
-import { isCancel, note, select } from "@clack/prompts";
+import { isCancel, note, select } from "@clack/prompts";
 import chalk from "chalk";
 import { configExists, loadConfig, saveConfig } from "@/config-cache.js";
 import {
@@ -24,8 +24,6 @@ export function formatConfig(responses) {
       ? "Feature-based"
       : responses.architecture === "type-based" || responses.architecture === "component-based"
       ? "Type-based"
-      : responses.architecture === "hybrid"
-      ? "Hybrid (shared + features)"
       : responses.architecture === "none"
       ? "None (flat src)"
       : responses.architecture;
@@ -71,9 +69,19 @@ export function formatConfig(responses) {
   if (responses.adapter && responses.adapter !== "none") {
     lines.push(`• ${chalk.bold("Adapter:")} ${chalk.cyan(responses.adapter)}`);
   }
+  if (responses.database && responses.database !== "none") {
+    const providerLabel = responses.databaseProvider === "supabase" ? " (Supabase)" : " (PostgreSQL)";
+    lines.push(`• ${chalk.bold("Database:")} ${chalk.cyan(responses.database === "prisma" ? `Prisma ORM${providerLabel}` : responses.database)}`);
+  }
   if (responses.reactCompiler !== undefined) {
     lines.push(`• ${chalk.bold("React Compiler:")} ${responses.reactCompiler ? chalk.green("Yes") : chalk.red("No")}`);
   }
+  if (responses.routeGroups !== undefined) {
+    lines.push(`• ${chalk.bold("Route Groups:")} ${responses.routeGroups ? chalk.green("Yes") : chalk.red("No")}`);
+  }
+  if (responses.docker !== undefined) {
+    lines.push(`• ${chalk.bold("Docker:")} ${responses.docker ? chalk.green("Yes") : chalk.red("No")}`);
+  }
   lines.push(
     `• ${chalk.bold("State:")} ${chalk.blue(state)}`,
     `• ${chalk.bold("Icons:")} ${chalk.blue(responses.iconLibrary === "none" ? "None" : responses.iconLibrary === "lucide" ? "Lucide" : "Huge")}`,
@@ -351,11 +359,6 @@ export async function getUserInputs(
             value: "type-based",
             hint: "Small apps / component libraries — code grouped by UI type",
           },
-          {
-            label: "Hybrid",
-            value: "hybrid",
-            hint: "Next.js: features + shared code",
-          },
           {
             label: "None",
             value: "none",
@@ -410,7 +413,15 @@ export async function getUserInputs(
         { label: "Jest", value: "jest" },
         { label: "None", value: "none" },
       ],
-      defaultInitial: "vitest",
+      defaultInitial: (ans) => {
+        const fw = normalizeFramework(
+          ans.framework || {
+            name: ans.frameworkName,
+            variant: ans.frameworkVariant,
+          }
+        );
+        return fw.name === "next" ? "none" : "vitest";
+      },
     },
     {
       id: "router",
@@ -456,6 +467,45 @@ export async function getUserInputs(
         ]),
       defaultInitial: "none",
     },
+    {
+      id: "database",
+      skip: () => !isPromptVisible(framework, "database"),
+      onSkip: (ans) => {
+        ans.database = "none";
+      },
+      message: "Which database ORM do you want to use?",
+      getOptions: () =>
+        filterCompatibleChoices(framework, "database", [
+          {
+            label: "Prisma ORM",
+            value: "prisma",
+            hint: "PostgreSQL schema, client singleton, seed script",
+          },
+          { label: "None", value: "none" },
+        ]),
+      defaultInitial: "none",
+    },
+    {
+      id: "databaseProvider",
+      skip: (ans) => !isPromptVisible(framework, "database") || ans.database !== "prisma",
+      onSkip: (ans) => {
+        ans.databaseProvider = ans.database === "prisma" ? (ans.databaseProvider || "postgresql") : undefined;
+      },
+      message: "Which database provider do you want to configure?",
+      getOptions: () => [
+        {
+          label: "PostgreSQL",
+          value: "postgresql",
+          hint: "Standard PostgreSQL / Docker compose",
+        },
+        {
+          label: "Supabase",
+          value: "supabase",
+          hint: "PostgreSQL with connection pooling & direct migration URL",
+        },
+      ],
+      defaultInitial: "postgresql",
+    },
     {
       id: "reactCompiler",
       skip: () => !isPromptVisible(framework, "reactCompiler"),
@@ -469,6 +519,32 @@ export async function getUserInputs(
       ],
       defaultInitial: false,
     },
+    {
+      id: "routeGroups",
+      skip: () => !isPromptVisible(framework, "routeGroups"),
+      onSkip: (ans) => {
+        ans.routeGroups = false;
+      },
+      message: "Include route groups preset (public, auth, private, admin)?",
+      getOptions: () => [
+        { label: "No (default)", value: false },
+        { label: "Yes", value: true },
+      ],
+      defaultInitial: false,
+    },
+    {
+      id: "docker",
+      skip: () => !isPromptVisible(framework, "docker"),
+      onSkip: (ans) => {
+        ans.docker = false;
+      },
+      message: "Include Docker setup?",
+      getOptions: () => [
+        { label: "No (default)", value: false },
+        { label: "Yes", value: true, hint: "Multi-stage Dockerfile and docker-compose" },
+      ],
+      defaultInitial: false,
+    },
     {
       id: "stateManagement",
       message: "Which state management library do you want to use?",
@@ -560,10 +636,10 @@ export async function getUserInputs(
     },
     {
       id: "agentDocs",
-      message: "Generate .lumen/ agent context for AI assistants?",
+      message: "Generate AGENTS.md for AI assistants?",
       getOptions: () => [
         { label: "No (default)", value: false },
-        { label: "Yes", value: true, hint: "Emits .lumen/ with project, architecture and conventions" },
+        { label: "Yes", value: true, hint: "Emits AGENTS.md referencing lumen.config.json (SSOT)" },
       ],
       defaultInitial: false,
     },
@@ -620,8 +696,12 @@ export async function getUserInputs(
     quickSetup: _quickSetup,
     bundler,
     adapter,
+    database,
+    databaseProvider,
     reactCompiler,
+    routeGroups,
     agentDocs,
+    docker,
     ...picked
   } = responses;
   // Final safety net: BACK-navigation can reselect the framework after other
@@ -638,12 +718,22 @@ export async function getUserInputs(
   if (adapter !== undefined && adapter !== "none") {
     finalResponses.adapter = adapter;
   }
+  if (database !== undefined && database !== "none") {
+    finalResponses.database = database;
+    finalResponses.databaseProvider = databaseProvider || "postgresql";
+  }
   if (reactCompiler !== undefined) {
     finalResponses.reactCompiler = reactCompiler;
   }
+  if (routeGroups !== undefined) {
+    finalResponses.routeGroups = routeGroups;
+  }
   if (agentDocs !== undefined) {
     finalResponses.agentDocs = agentDocs;
   }
+  if (docker !== undefined) {
+    finalResponses.docker = docker;
+  }
 
   // No config cache write until final confirm!
   await saveConfigFn(finalResponses);

package/src/readme.js

@@ -117,22 +117,6 @@ ${nestedTree(appChildren)}
 ${nestedTree(shared)}`;
   }
 
-  if (responses.architecture === "hybrid") {
-    const shared = [
-      "components/ # Shared UI components",
-      "hooks/    # Shared custom hooks",
-      "layouts/  # High-level layout wrappers",
-      "stores/   # Global state stores",
-      `styles/   # ${responses.cssFramework === "none" ? "main.css (reset) + themes.css (CSS variables)" : "globals.css (framework directives) + themes.css"}`,
-      "types/    # Global type definitions",
-      "utils/    # Pure utility functions",
-    ];
-    return `src/
-├── features/     # Feature modules (domain boundaries)
-└── shared/       # Reusable, business-agnostic resources
-${nestedTree(shared)}`;
-  }
-
   if (responses.architecture === "none") {
     return `src/
 ├── App.${responses.language === "ts" ? "tsx" : "jsx"}          # Root application component

package/src/utils/dev-server.js

@@ -2,7 +2,12 @@ import { isCancel, select } from "@clack/prompts";
 import chalk from "chalk";
 import { execa } from "execa";
 
-export async function handleDevServer(pkg, projectName) {
+export async function handleDevServer(pkg, projectName, { isNonInteractive = false } = {}) {
+  if (isNonInteractive || process.env.CI || !process.stdin.isTTY) {
+    printNextSteps(projectName, pkg);
+    return;
+  }
+
   const startDev = await select({
     message: "Start the development server?",
     options: [

package/templates/.env.example

@@ -1,4 +1,4 @@
 # Copy this file to `.env.local` (or `.env`) and fill in your values.
-# See https://vitejs.dev/guide/env-and-mode for how env vars are exposed.
+# See https://vite.dev/guide/env-and-mode for how env vars are exposed.
 
 VITE_API_URL=https://api.example.com

package/templates/architectures/feature-based/scripts/create-feature.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import fs from "fs";
-import path from "path";
+import fs from "node:fs";
+import path from "node:path";
 
 // 1. Get feature name from CLI args
 const featureName = process.argv[2];

package/templates/conditional/database/prisma/db.js

@@ -0,0 +1,14 @@
+import { PrismaClient } from "@prisma/client";
+
+const globalForPrisma = globalThis;
+
+export const db =
+  globalForPrisma.prisma ||
+  new PrismaClient({
+    log:
+      process.env.NODE_ENV === "development"
+        ? ["query", "error", "warn"]
+        : ["error"],
+  });
+
+if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = db;

package/templates/conditional/database/prisma/db.ts

@@ -0,0 +1,16 @@
+import { PrismaClient } from "@prisma/client";
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined;
+};
+
+export const db =
+  globalForPrisma.prisma ??
+  new PrismaClient({
+    log:
+      process.env.NODE_ENV === "development"
+        ? ["query", "error", "warn"]
+        : ["error"],
+  });
+
+if (process.env.NODE_ENV !== "production") globalForPrisma.prisma = db;

package/templates/conditional/database/prisma/schema.prisma

@@ -0,0 +1,9 @@
+datasource db {
+  provider  = "postgresql"
+  url       = env("DATABASE_URL")
+  directUrl = env("DIRECT_URL")
+}
+
+generator client {
+  provider = "prisma-client-js"
+}

package/templates/conditional/database/prisma/seed.js

@@ -0,0 +1,16 @@
+const { PrismaClient } = require("@prisma/client");
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log("Database seeded successfully");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/templates/conditional/database/prisma/seed.ts

@@ -0,0 +1,16 @@
+import { PrismaClient } from "@prisma/client";
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log("Database seeded successfully");
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

package/templates/conditional/docker/.dockerignore

@@ -0,0 +1,10 @@
+node_modules
+.next
+.git
+.gitignore
+.env*
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+README.md

package/templates/conditional/docker/Dockerfile

@@ -0,0 +1,57 @@
+FROM node:22-alpine AS base
+
+# Install dependencies only when needed
+FROM base AS deps
+# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed.
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+# Install dependencies based on the preferred package manager
+COPY package.json package-lock.json* yarn.lock* pnpm-lock.yaml* bun.lockb* bun.lock* ./
+RUN \
+  if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
+  elif [ -f pnpm-lock.yaml ]; then corepack enable pnpm && pnpm i --frozen-lockfile; \
+  elif [ -f package-lock.json ]; then npm ci; \
+  elif [ -f bun.lockb ] || [ -f bun.lock ]; then corepack enable bun && bun install --frozen-lockfile; \
+  else npm i; \
+  fi
+
+# Rebuild the source code only when needed
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+# Next.js collects completely anonymous telemetry data about general usage.
+# Learn more here: https://nextjs.org/telemetry
+# Uncomment the following line in case you want to disable telemetry during the build.
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN npm run build
+
+# Production image, copy all the files and run next
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+# Uncomment the following line in case you want to disable telemetry during runtime.
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --chown=nextjs:nodejs public ./public
+
+# Automatically leverage output traces to reduce image size
+# https://nextjs.org/docs/advanced-features/output-file-tracing
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+CMD ["node", "server.js"]

package/templates/conditional/docker/docker-compose.yml

@@ -0,0 +1,35 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: always
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - DATABASE_URL=postgresql://postgres:postgres@db:5432/app?schema=public
+    depends_on:
+      db:
+        condition: service_healthy
+
+  db:
+    image: postgres:16-alpine
+    restart: always
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: app
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres -d app"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:

package/templates/conditional/linting/biome/biome.json

@@ -1,31 +1,37 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "vcs": {
-    "enabled": false,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
+  "$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
   "files": {
     "ignoreUnknown": false,
-    "ignore": []
+    "includes": ["**", "!**/.next", "!**/dist", "!**/node_modules"]
   },
   "formatter": {
     "enabled": true,
     "indentStyle": "space",
     "indentWidth": 2
   },
-  "organizeImports": {
-    "enabled": true
-  },
   "linter": {
     "enabled": true,
     "rules": {
-      "recommended": true
+      "preset": "recommended"
     }
   },
   "javascript": {
     "formatter": {
       "quoteStyle": "double"
     }
+  },
+  "css": {
+    "parser": {
+      "tailwindDirectives": true
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
   }
 }
+

package/templates/conditional/linting/eslint/next/eslint.config.mjs

@@ -1,16 +1,7 @@
-import { dirname } from "path";
-import { fileURLToPath } from "url";
-import { FlatCompat } from "@eslint/eslintrc";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const compat = new FlatCompat({
-  baseDirectory: __dirname,
-});
+import nextConfig from "eslint-config-next";
 
 const eslintConfig = [
-  ...compat.extends("next/core-web-vitals"),
+  ...nextConfig,
 ];
 
 export default eslintConfig;

package/templates/conditional/next/route-groups/js/src/app/(admin)/layout.jsx

@@ -0,0 +1,23 @@
+import Link from "next/link";
+
+export default function AdminLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="bg-red-700 text-white px-6 py-3 flex items-center justify-between text-sm">
+        <div className="font-semibold flex items-center gap-2">
+          <span className="inline-block w-2 h-2 rounded-full bg-white animate-pulse" />
+          Admin Panel (Restricted Access)
+        </div>
+        <nav className="flex gap-4">
+          <Link href="/admin" className="underline hover:no-underline">
+            Management
+          </Link>
+          <Link href="/dashboard" className="underline hover:no-underline">
+            Exit to Dashboard
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1 p-8 bg-gray-100 dark:bg-gray-900">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(auth)/layout.jsx

@@ -0,0 +1,17 @@
+import Link from "next/link";
+
+export default function AuthLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col justify-center items-center bg-gray-50 dark:bg-gray-950 p-4">
+      <div className="w-full max-w-md bg-white dark:bg-gray-900 shadow-md rounded-lg p-6 border border-gray-200 dark:border-gray-800">
+        <div className="mb-6 text-center">
+          <Link href="/" className="text-xl font-bold">
+            Lumen Authentication
+          </Link>
+          <p className="text-sm text-gray-500 mt-1">Sign in to your account</p>
+        </div>
+        {children}
+      </div>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(private)/layout.jsx

@@ -0,0 +1,27 @@
+import Link from "next/link";
+
+export default function PrivateLayout({ children }) {
+  return (
+    <div className="min-h-screen flex">
+      <aside className="w-64 border-r bg-gray-50 dark:bg-gray-950 p-6 flex flex-col justify-between">
+        <div>
+          <div className="font-bold text-lg mb-6">
+            <Link href="/dashboard">Private Dashboard</Link>
+          </div>
+          <nav className="flex flex-col gap-3 text-sm">
+            <Link href="/dashboard" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Overview
+            </Link>
+            <Link href="/settings" className="text-gray-700 dark:text-gray-200 hover:text-black">
+              Settings
+            </Link>
+          </nav>
+        </div>
+        <div className="text-xs text-gray-400">
+          Protected Area &bull; Authenticated
+        </div>
+      </aside>
+      <main className="flex-1 p-8">{children}</main>
+    </div>
+  );
+}

package/templates/conditional/next/route-groups/js/src/app/(public)/layout.jsx

@@ -0,0 +1,28 @@
+import Link from "next/link";
+
+export default function PublicLayout({ children }) {
+  return (
+    <div className="min-h-screen flex flex-col">
+      <header className="border-b px-6 py-4 flex items-center justify-between">
+        <div className="font-bold text-lg">
+          <Link href="/">Lumen App</Link>
+        </div>
+        <nav className="flex gap-4 text-sm">
+          <Link href="/login" className="hover:underline">
+            Sign In
+          </Link>
+          <Link href="/dashboard" className="hover:underline">
+            Dashboard
+          </Link>
+          <Link href="/admin" className="hover:underline">
+            Admin
+          </Link>
+        </nav>
+      </header>
+      <main className="flex-1">{children}</main>
+      <footer className="border-t px-6 py-4 text-center text-sm text-gray-500">
+        Public Area &copy; {new Date().getFullYear()}
+      </footer>
+    </div>
+  );
+}