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

package/src/css.js

@@ -17,7 +17,6 @@ export async function setupCssFramework({
   pkg: _pkg,
   framework = "vite",
 }) {
-  process.chdir(projectPath);
   const fw = normalizeFramework(framework);
   const isFilesystemRouted = hasCapability(fw, CAPABILITIES.FILESYSTEM_ROUTING);
   const cssDir = path.join(templatesDir, "css");
@@ -26,7 +25,7 @@ export async function setupCssFramework({
   // main.css). The chosen framework's styles land in the file the architecture
   // actually imports.
   const stylesDir =
-    architecture === "feature-based" || architecture === "hybrid"
+    architecture === "feature-based"
       ? path.join(projectPath, "src", "shared", "styles")
       : path.join(projectPath, "src", "styles");
 
@@ -100,11 +99,11 @@ async function syncMainCssImport(projectPath, ext, architecture, mainFileName) {
   try {
     let content = await fsp.readFile(mainPath, "utf8");
     const expected =
-      architecture === "feature-based" || architecture === "hybrid"
+      architecture === "feature-based"
         ? `./shared/styles/${mainFileName}`
         : `./styles/${mainFileName}`;
     const wrong =
-      architecture === "feature-based" || architecture === "hybrid"
+      architecture === "feature-based"
         ? /import ['"]\.\/shared\/styles\/(globals|main)\.css['"]/
         : /import ['"]\.\/styles\/(globals|main)\.css['"]/;
     content = content.replace(wrong, `import '${expected}'`);

package/src/dependencies.js

@@ -1,4 +1,5 @@
 import { execa } from "execa";
+import { normalizeFramework } from "./engine/capabilities.js";
 
 export async function installDeps(pkgManager, dev, packages, cwd) {
   let cmd, args;
@@ -40,11 +41,15 @@ export async function installAllDeps(responses, pkg, cwd) {
 // the conditional wiring stays verifiable without a network install.
 export function computeDeps(responses) {
   const deps = [];
-  const fwName =
-    typeof responses.framework === "string"
-      ? responses.framework
-      : (responses.framework?.name ?? responses.frameworkName ?? "react");
+  const fw = normalizeFramework(
+    responses.framework || {
+      name: responses.frameworkName,
+      variant: responses.frameworkVariant,
+    }
+  );
+  const fwName = fw.name;
   const cssDevDeps = [];
+  const databaseDevDeps = [];
   const testingDevDeps = [];
   const linterDevDeps = [];
   const formatterDevDeps = [];
@@ -83,6 +88,15 @@ export function computeDeps(responses) {
     deps.push("axios");
   }
 
+  // Database
+  if (responses.database === "prisma") {
+    deps.push("@prisma/client@^6");
+    databaseDevDeps.push("prisma@^6");
+    if (responses.language === "ts") {
+      databaseDevDeps.push("tsx");
+    }
+  }
+
   // Testing
   if (responses.testing === "vitest") {
     testingDevDeps.push(
@@ -92,17 +106,29 @@ export function computeDeps(responses) {
       "jsdom"
     );
   } else if (responses.testing === "jest") {
-    testingDevDeps.push(
-      "jest",
-      "jest-environment-jsdom",
-      "@testing-library/react",
-      "@testing-library/jest-dom",
-      "jsdom",
-      "babel-jest",
-      "@babel/preset-env",
-      "@babel/preset-react",
-      "@babel/preset-typescript"
-    );
+    if (fwName === "next") {
+      testingDevDeps.push(
+        "jest",
+        "jest-environment-jsdom",
+        "@testing-library/react",
+        "@testing-library/jest-dom"
+      );
+      if (responses.language === "ts") {
+        testingDevDeps.push("@types/jest");
+      }
+    } else {
+      testingDevDeps.push(
+        "jest",
+        "jest-environment-jsdom",
+        "@testing-library/react",
+        "@testing-library/jest-dom",
+        "jsdom",
+        "babel-jest",
+        "@babel/preset-env",
+        "@babel/preset-react",
+        "@babel/preset-typescript"
+      );
+    }
   }
 
   // Linter
@@ -136,6 +162,7 @@ export function computeDeps(responses) {
 
   const devDepBatches = [
     cssDevDeps,
+    databaseDevDeps,
     testingDevDeps,
     linterDevDeps,
     formatterDevDeps,

package/src/engine/capabilities.js

@@ -18,6 +18,9 @@ export const CAPABILITIES = {
   NEXT_IMAGE: "next-image",
   SPA_FALLBACK: "spa-fallback",
   AGENT_DOCS: "agent-docs",
+  DATABASE: "database",
+  DOCKER: "docker",
+  ROUTE_GROUPS: "route-groups",
 };
 
 export const FRAMEWORK_CAPABILITIES = {
@@ -37,6 +40,7 @@ export const FRAMEWORK_CAPABILITIES = {
     allowedFormatters: ["prettier", "oxfmt", "none"],
     allowedBundlers: [],
     allowedAdapters: [],
+    allowedDatabases: [],
     supportsRouterPrompt: true,
   },
   "next:app-router": {
@@ -52,8 +56,11 @@ export const FRAMEWORK_CAPABILITIES = {
       CAPABILITIES.NEXT_FONT,
       CAPABILITIES.NEXT_IMAGE,
       CAPABILITIES.AGENT_DOCS,
+      CAPABILITIES.DATABASE,
+      CAPABILITIES.DOCKER,
+      CAPABILITIES.ROUTE_GROUPS,
     ],
-    allowedArchitectures: ["feature-based", "hybrid", "none"],
+    allowedArchitectures: ["feature-based", "none"],
     allowedStyling: ["tailwind", "none"],
     allowedUiKits: ["shadcn", "none"],
     allowedLanguages: ["ts", "js"],
@@ -61,6 +68,7 @@ export const FRAMEWORK_CAPABILITIES = {
     allowedFormatters: ["prettier", "none"],
     allowedBundlers: ["turbopack", "webpack"],
     allowedAdapters: ["node", "vercel", "cloudflare", "static"],
+    allowedDatabases: ["prisma", "none"],
     supportsRouterPrompt: false, // filesystem routing is built-in
   },
   "next:pages-router": {
@@ -74,8 +82,10 @@ export const FRAMEWORK_CAPABILITIES = {
       CAPABILITIES.NEXT_FONT,
       CAPABILITIES.NEXT_IMAGE,
       CAPABILITIES.AGENT_DOCS,
+      CAPABILITIES.DATABASE,
+      CAPABILITIES.DOCKER,
     ],
-    allowedArchitectures: ["feature-based", "hybrid", "none"],
+    allowedArchitectures: ["feature-based", "none"],
     allowedStyling: ["tailwind", "none"],
     allowedUiKits: ["shadcn", "none"],
     allowedLanguages: ["ts", "js"],
@@ -83,6 +93,7 @@ export const FRAMEWORK_CAPABILITIES = {
     allowedFormatters: ["prettier", "none"],
     allowedBundlers: ["turbopack", "webpack"],
     allowedAdapters: ["node", "vercel", "cloudflare", "static"],
+    allowedDatabases: ["prisma", "none"],
     supportsRouterPrompt: false, // filesystem routing is built-in
   },
 };
@@ -168,6 +179,22 @@ export function isOptionCompatible(framework, optionKey, optionValue) {
         return hasCapability(framework, CAPABILITIES.REACT_COMPILER);
       }
       return true;
+    case "database":
+    case "db":
+      if (!desc.allowedDatabases || desc.allowedDatabases.length === 0) {
+        return optionValue === "none" || !optionValue;
+      }
+      return desc.allowedDatabases.includes(optionValue);
+    case "docker":
+      if (optionValue === true) {
+        return hasCapability(framework, CAPABILITIES.DOCKER);
+      }
+      return true;
+    case "routeGroups":
+      if (optionValue === true) {
+        return hasCapability(framework, CAPABILITIES.ROUTE_GROUPS);
+      }
+      return true;
     default:
       return true;
   }
@@ -192,6 +219,7 @@ export function getCompatibleOptions(framework) {
     formatters: [...desc.allowedFormatters],
     bundlers: [...desc.allowedBundlers],
     adapters: [...desc.allowedAdapters],
+    databases: [...(desc.allowedDatabases || [])],
     supportsRouterPrompt: desc.supportsRouterPrompt,
   };
 }
@@ -289,6 +317,12 @@ export function isPromptVisible(framework, promptName) {
       return hasCapability(fw, CAPABILITIES.ADAPTERS);
     case "reactCompiler":
       return hasCapability(fw, CAPABILITIES.REACT_COMPILER);
+    case "database":
+      return hasCapability(fw, CAPABILITIES.DATABASE);
+    case "docker":
+      return hasCapability(fw, CAPABILITIES.DOCKER);
+    case "routeGroups":
+      return hasCapability(fw, CAPABILITIES.ROUTE_GROUPS);
     default:
       return true;
   }
@@ -334,6 +368,9 @@ export function getDefaultResponses(framework, { projectName = "my-app" } = {})
       stateManagement: "none",
       iconLibrary: "none",
       apiClient: "none",
+      database: "none",
+      docker: false,
+      routeGroups: false,
       linter: "eslint",
       formatter: "prettier",
       docsLanguage: "en",
@@ -355,6 +392,9 @@ export function getDefaultResponses(framework, { projectName = "my-app" } = {})
     stateManagement: "none",
     iconLibrary: "none",
     apiClient: "none",
+    database: "none",
+    docker: false,
+    routeGroups: false,
     linter: "eslint",
     formatter: "prettier",
     docsLanguage: "en",
@@ -390,6 +430,15 @@ export function sanitizeResponsesForFramework(framework, responses = {}) {
       sanitized.reactCompiler = false;
     }
   }
+  if (!isPromptVisible(fw, "database")) {
+    sanitized.database = "none";
+  }
+  if (!isPromptVisible(fw, "docker")) {
+    sanitized.docker = false;
+  }
+  if (!isPromptVisible(fw, "routeGroups")) {
+    sanitized.routeGroups = false;
+  }
 
   for (const [key, val] of Object.entries(sanitized)) {
     if (val === undefined || val === null) continue;

package/src/engine/composition.js

@@ -41,10 +41,13 @@ export const TOOLING_ORDER = [
   "router",
   "icons",
   "api",
+  "database",
   "testing",
   "linter",
   "feature-script",
   "next-config",
+  "route-groups",
+  "docker",
   "formatter",
 ];
 
@@ -163,7 +166,7 @@ export function resolveFragments(responses = {}, templatesDir) {
   });
 
   // =========================================================================
-  // Layer 3: Architecture (feature-based / type-based / hybrid / none)
+  // Layer 3: Architecture (feature-based / type-based / none)
   // =========================================================================
   const archSrcDir = path.join(templatesDir, "architectures", architecture, "src");
   const archMainSrc = path.join(templatesDir, "architectures", architecture, `main.${ext}`);
@@ -174,6 +177,24 @@ export function resolveFragments(responses = {}, templatesDir) {
     sourceDir: archSrcDir,
     targetDir: "src",
     action: async ({ projectPath }) => {
+      if (fw.name === "next") {
+        try { await fsp.rm(path.join(projectPath, "src", "main.tsx"), { force: true }); } catch {}
+        try { await fsp.rm(path.join(projectPath, "src", "main.jsx"), { force: true }); } catch {}
+        try { await fsp.rm(path.join(projectPath, "src", "App.tsx"), { force: true }); } catch {}
+        try { await fsp.rm(path.join(projectPath, "src", "App.jsx"), { force: true }); } catch {}
+        try { await fsp.rm(path.join(projectPath, "src", "App.css"), { force: true }); } catch {}
+        if (fw.variant === "pages-router") {
+          try { await fsp.rm(path.join(projectPath, "src", "app"), { recursive: true, force: true }); } catch {}
+        } else {
+          // Next App Router: preserve file-system routes; purge React/Vite-specific application layer
+          try { await fsp.rm(path.join(projectPath, "src", "app", "App.tsx"), { force: true }); } catch {}
+          try { await fsp.rm(path.join(projectPath, "src", "app", "App.jsx"), { force: true }); } catch {}
+          try { await fsp.rm(path.join(projectPath, "src", "app", "hooks"), { recursive: true, force: true }); } catch {}
+          try { await fsp.rm(path.join(projectPath, "src", "app", "contexts"), { recursive: true, force: true }); } catch {}
+          try { await fsp.rm(path.join(projectPath, "src", "app", "providers"), { recursive: true, force: true }); } catch {}
+        }
+        return;
+      }
       // Copy architecture main entry
       try {
         await fsp.access(archMainSrc);
@@ -204,6 +225,16 @@ export function resolveFragments(responses = {}, templatesDir) {
       id: `styling:${cssFramework}:components`,
       sourceDir: componentStylesDir,
       targetDir: "src",
+      action: async ({ projectPath }) => {
+        if (fw.name === "next") {
+          if (fw.variant === "pages-router") {
+            try { await fsp.rm(path.join(projectPath, "src", "app"), { recursive: true, force: true }); } catch {}
+          } else {
+            try { await fsp.rm(path.join(projectPath, "src", "app", "App.tsx"), { force: true }); } catch {}
+            try { await fsp.rm(path.join(projectPath, "src", "app", "App.jsx"), { force: true }); } catch {}
+          }
+        }
+      },
     });
   }
 
@@ -220,6 +251,7 @@ export function resolveFragments(responses = {}, templatesDir) {
       sourceDir: path.join(templatesDir, "conditional", "state", "redux", architecture, "src"),
       targetDir: "src",
       action: async ({ projectPath }) => {
+        if (fw.name === "next") return;
         await updateMainWithProvider(projectPath, "redux", architecture, ext);
       },
     });
@@ -316,6 +348,111 @@ export function resolveFragments(responses = {}, templatesDir) {
       id: `tooling:api:${responses.apiClient}`,
       sourceDir: apiDir,
       targetDir: "src",
+      action: async ({ projectPath }) => {
+        if (fw.name === "next") {
+          const configCandidates = [
+            path.join(projectPath, "src", "config", `axios.config.${extConfig}`),
+            path.join(projectPath, "src", "shared", "lib", "axios", `api.config.${extConfig}`),
+            path.join(projectPath, "src", "config", `api.config.${extConfig}`),
+            path.join(projectPath, "src", "shared", "api", `api.config.${extConfig}`),
+          ];
+          for (const cfgPath of configCandidates) {
+            try {
+              let content = await fsp.readFile(cfgPath, "utf8");
+              if (content.includes("import.meta.env.VITE_API_URL")) {
+                content = content.replace(
+                  /import\.meta\.env\.VITE_API_URL/g,
+                  "process.env.NEXT_PUBLIC_API_URL"
+                );
+                await fsp.writeFile(cfgPath, content, "utf8");
+              }
+            } catch {}
+          }
+        }
+      },
+    });
+  }
+
+  // 5.45 Database (Prisma)
+  if (responses.database === "prisma") {
+    fragments.push({
+      scope: FRAGMENT_SCOPES.TOOLING,
+      category: "database",
+      id: "tooling:database:prisma",
+      scripts: {
+        "db:generate": "prisma generate",
+        "db:push": "prisma db push",
+        "db:seed": "prisma db seed",
+        "db:studio": "prisma studio",
+      },
+      action: async ({ projectPath, templatesDir: tDir }) => {
+        const prismaTplDir = path.join(tDir, "conditional", "database", "prisma");
+        const prismaDir = path.join(projectPath, "prisma");
+        await fsp.mkdir(prismaDir, { recursive: true });
+
+        // Copy schema.prisma
+        const schemaSrc = path.join(prismaTplDir, "schema.prisma");
+        const schemaDest = path.join(prismaDir, "schema.prisma");
+        try {
+          await fsp.access(schemaSrc);
+          await fsp.copyFile(schemaSrc, schemaDest);
+        } catch {}
+
+        // Copy seed file: prisma/seed.ts or prisma/seed.js
+        const seedFileName = language === "ts" ? "seed.ts" : "seed.js";
+        const seedSrc = path.join(prismaTplDir, seedFileName);
+        const seedDest = path.join(prismaDir, seedFileName);
+        try {
+          await fsp.access(seedSrc);
+          await fsp.copyFile(seedSrc, seedDest);
+        } catch {}
+
+        // Copy client singleton: src/lib/db.ts or src/lib/db.js
+        const libDir = path.join(projectPath, "src", "lib");
+        await fsp.mkdir(libDir, { recursive: true });
+        const dbFileName = language === "ts" ? "db.ts" : "db.js";
+        const dbSrc = path.join(prismaTplDir, dbFileName);
+        const dbDest = path.join(libDir, dbFileName);
+        try {
+          await fsp.access(dbSrc);
+          await fsp.copyFile(dbSrc, dbDest);
+        } catch {}
+
+        // Configure prisma.seed in package.json
+        const pkgPath = path.join(projectPath, "package.json");
+        try {
+          const content = await fsp.readFile(pkgPath, "utf8");
+          const pkg = JSON.parse(content);
+          pkg.prisma = {
+            seed: language === "ts" ? "tsx prisma/seed.ts" : "node prisma/seed.js",
+          };
+          await fsp.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+        } catch {}
+
+        // Append DATABASE_URL and DIRECT_URL to .env.example
+        const envExamplePath = path.join(projectPath, ".env.example");
+        const envLines = [
+          "",
+          "# Database (Prisma + PostgreSQL)",
+          "# Local development with PostgreSQL or Docker compose (docker compose up -d db):",
+          'DATABASE_URL="postgresql://postgres:postgres@localhost:5432/app?schema=public"',
+          'DIRECT_URL="postgresql://postgres:postgres@localhost:5432/app?schema=public"',
+          "",
+          "# Supabase / cloud PostgreSQL with connection pooling (Transaction mode / port 6543):",
+          '# DATABASE_URL="postgresql://postgres:[YOUR-PASSWORD]@db.[YOUR-PROJECT-REF].supabase.co:6543/postgres?pgbouncer=true"',
+          '# DIRECT_URL="postgresql://postgres:[YOUR-PASSWORD]@db.[YOUR-PROJECT-REF].supabase.co:5432/postgres"',
+        ].join("\n");
+        try {
+          let envContent = "";
+          try {
+            envContent = await fsp.readFile(envExamplePath, "utf8");
+          } catch {}
+          if (!envContent.includes("DATABASE_URL")) {
+            envContent = envContent.trimEnd() + "\n" + envLines.trimStart() + "\n";
+            await writeFileRecursive(envExamplePath, envContent);
+          }
+        } catch {}
+      },
     });
   }
 
@@ -325,7 +462,7 @@ export function resolveFragments(responses = {}, templatesDir) {
     const testingDir = path.join(templatesDir, "conditional", "testing", testingFramework);
     const testScripts =
       testingFramework === "vitest"
-        ? { test: "vitest", "test:run": "vitest run" }
+        ? { test: "vitest", "test:run": "vitest run", "test:watch": "vitest" }
         : { test: "jest", "test:watch": "jest --watch" };
 
     fragments.push({
@@ -335,11 +472,26 @@ export function resolveFragments(responses = {}, templatesDir) {
       scripts: testScripts,
       action: async ({ projectPath }) => {
         // Config file to project root
-        const configSrc = path.join(testingDir, `${testingFramework}.config.${extConfig}`);
-        try {
-          await fsp.access(configSrc);
-          await fsp.copyFile(configSrc, path.join(projectPath, `${testingFramework}.config.${extConfig}`));
-        } catch {}
+        if (testingFramework === "jest" && fw.name === "next") {
+          const nextConfigExt = language === "ts" ? "ts" : "mjs";
+          const configSrc = path.join(testingDir, "next", `jest.config.${nextConfigExt}`);
+          try {
+            await fsp.access(configSrc);
+            await fsp.copyFile(configSrc, path.join(projectPath, `jest.config.${nextConfigExt}`));
+          } catch {}
+        } else if (testingFramework === "vitest" && fw.name === "next") {
+          const configSrc = path.join(testingDir, "next", `vitest.config.${extConfig}`);
+          try {
+            await fsp.access(configSrc);
+            await fsp.copyFile(configSrc, path.join(projectPath, `vitest.config.${extConfig}`));
+          } catch {}
+        } else {
+          const configSrc = path.join(testingDir, `${testingFramework}.config.${extConfig}`);
+          try {
+            await fsp.access(configSrc);
+            await fsp.copyFile(configSrc, path.join(projectPath, `${testingFramework}.config.${extConfig}`));
+          } catch {}
+        }
 
         // Setup file to src/test/setup.*
         const setupSrc = path.join(testingDir, `src/test/setup.${extConfig}`);
@@ -355,20 +507,43 @@ export function resolveFragments(responses = {}, templatesDir) {
             await fsp.access(jestSetupSrc);
             await fsp.copyFile(jestSetupSrc, path.join(projectPath, `jest.setup.${extConfig}`));
           } catch {}
-          const babelSrc = path.join(testingDir, "babel.config.cjs");
+          if (fw.name !== "next") {
+            const babelSrc = path.join(testingDir, "babel.config.cjs");
+            try {
+              await fsp.access(babelSrc);
+              await fsp.copyFile(babelSrc, path.join(projectPath, "babel.config.cjs"));
+            } catch {}
+          }
+        }
+
+        if (fw.name === "next") {
+          const testFileName = fw.variant === "pages-router" ? "index" : "page";
+          const testSrc = path.join(
+            testingDir,
+            "next",
+            fw.variant,
+            "src",
+            "__tests__",
+            `${testFileName}.test.${ext}`
+          );
+          try {
+            await fsp.access(testSrc);
+            const testDest = path.join(projectPath, "src", "__tests__", `${testFileName}.test.${ext}`);
+            let testContent = await fsp.readFile(testSrc, "utf8");
+            if (responses.routeGroups === true && fw.variant === "app-router") {
+              testContent = testContent.replace("@/app/page", "@/app/(public)/page");
+            }
+            await writeFileRecursive(testDest, testContent);
+          } catch {}
+        } else {
+          // Architecture-scoped test file
+          const testSrc = path.join(testingDir, architecture, `src/__tests__/App.test.${ext}`);
           try {
-            await fsp.access(babelSrc);
-            await fsp.copyFile(babelSrc, path.join(projectPath, "babel.config.cjs"));
+            await fsp.access(testSrc);
+            const testDest = path.join(projectPath, "src", "__tests__", `App.test.${ext}`);
+            await writeFileRecursive(testDest, await fsp.readFile(testSrc, "utf8"));
           } catch {}
         }
-
-        // Architecture-scoped test file
-        const testSrc = path.join(testingDir, architecture, `src/__tests__/App.test.${ext}`);
-        try {
-          await fsp.access(testSrc);
-          const testDest = path.join(projectPath, "src", "__tests__", `App.test.${ext}`);
-          await writeFileRecursive(testDest, await fsp.readFile(testSrc, "utf8"));
-        } catch {}
       },
     });
   }
@@ -417,14 +592,24 @@ export function resolveFragments(responses = {}, templatesDir) {
       },
     });
   } else if (responses.linter === "biome") {
+    const isBiomeFormatter =
+      !responses.formatter ||
+      responses.formatter === "none" ||
+      responses.formatter === "biome";
+    const biomeScripts = {
+      lint: "biome check .",
+      "lint:fix": "biome check --write .",
+    };
+    if (isBiomeFormatter) {
+      biomeScripts.format = "biome check --write .";
+      biomeScripts["format:check"] = "biome check .";
+    }
+
     fragments.push({
       scope: FRAGMENT_SCOPES.TOOLING,
       category: "linter",
       id: "tooling:linter:biome",
-      scripts: {
-        lint: "biome check .",
-        "lint:fix": "biome check --write .",
-      },
+      scripts: biomeScripts,
       action: async ({ projectPath }) => {
         const configSrc = path.join(templatesDir, "conditional", "linting", "biome", "biome.json");
         try {
@@ -525,11 +710,85 @@ export function resolveFragments(responses = {}, templatesDir) {
             }
           } catch {}
         }
+
+        // Apply standalone output to next.config if docker is enabled
+        if (responses.docker === true) {
+          const targetConfigPath = path.join(projectPath, `next.config.${configExt}`);
+          try {
+            let content = await fsp.readFile(targetConfigPath, "utf8");
+            if (!content.includes('"standalone"') && !content.includes("'standalone'")) {
+              content = content.replace(
+                /const nextConfig(?::\s*NextConfig)?\s*=\s*\{/,
+                (match) => `${match}\n  output: "standalone",`
+              );
+              await fsp.writeFile(targetConfigPath, content, "utf8");
+            }
+          } catch {}
+        }
+      },
+    });
+  }
+
+  // 5.8 Route Groups Preset & Auth Proxy Template (#64)
+  if (responses.routeGroups === true && fw.name === "next" && fw.variant === "app-router") {
+    fragments.push({
+      scope: FRAGMENT_SCOPES.TOOLING,
+      category: "route-groups",
+      id: "tooling:next:route-groups",
+      sourceDir: path.join(templatesDir, "conditional", "next", "route-groups", language),
+      targetDir: "",
+      action: async ({ projectPath }) => {
+        // Remove colliding root page so it does not collide with (public)/page
+        try {
+          await fsp.rm(path.join(projectPath, "src", "app", `page.${ext}`), { force: true });
+        } catch {}
+        const oppositeExt = language === "ts" ? "jsx" : "tsx";
+        try {
+          await fsp.rm(path.join(projectPath, "src", "app", `page.${oppositeExt}`), { force: true });
+        } catch {}
+        // Also remove page.js / page.tsx in case base provider was named page.js
+        try {
+          await fsp.rm(path.join(projectPath, "src", "app", "page.js"), { force: true });
+        } catch {}
+        try {
+          await fsp.rm(path.join(projectPath, "src", "app", "page.tsx"), { force: true });
+        } catch {}
+        // Adjust existing test file if it imported @/app/page before route groups was applied
+        for (const testExt of ["tsx", "jsx", "ts", "js"]) {
+          const testPath = path.join(projectPath, "src", "__tests__", `page.test.${testExt}`);
+          try {
+            const content = await fsp.readFile(testPath, "utf8");
+            if (content.includes("@/app/page")) {
+              await fsp.writeFile(testPath, content.replace(/@\/app\/page/g, "@/app/(public)/page"), "utf8");
+            }
+          } catch {}
+        }
+      },
+    });
+  }
+
+  // 5.9 Docker (Multi-stage Dockerfile and docker-compose for Next.js standalone)
+  if (responses.docker === true && hasCapability(fw, CAPABILITIES.DOCKER)) {
+    fragments.push({
+      scope: FRAGMENT_SCOPES.TOOLING,
+      category: "docker",
+      id: "tooling:docker",
+      action: async ({ projectPath }) => {
+        const dockerSrcDir = path.join(templatesDir, "conditional", "docker");
+        const filesToCopy = ["Dockerfile", ".dockerignore", "docker-compose.yml"];
+        for (const file of filesToCopy) {
+          const srcFile = path.join(dockerSrcDir, file);
+          const destFile = path.join(projectPath, file);
+          try {
+            await fsp.access(srcFile);
+            await fsp.copyFile(srcFile, destFile);
+          } catch {}
+        }
       },
     });
   }
 
-  // 5.8 Formatter
+  // 5.10 Formatter
   if (responses.formatter && responses.formatter !== "none") {
     const isPrettier = responses.formatter === "prettier";
     const configFile = isPrettier ? ".prettierrc" : ".oxfmtrc.json";