create-next-style-guide 0.1.6 → 0.1.8

package/dist/index.js

@@ -3,7 +3,7 @@
 // src/index.ts
 import * as p4 from "@clack/prompts";
 import color4 from "picocolors";
-import path31 from "path";
+import path32 from "path";
 
 // src/constants.ts
 import path from "path";
@@ -59,6 +59,10 @@ function ciInstallCommand(id) {
   }
 }
 
+// src/helpers/project-target.ts
+import fs from "fs-extra";
+import path2 from "path";
+
 // src/helpers/slugify.ts
 function slugify(name) {
   const slug = name.trim().toLowerCase().replace(/[\s.-]+/g, "_").replace(/[^a-z0-9_]/g, "").replace(/_+/g, "_").replace(/^_|_$/g, "");
@@ -71,6 +75,60 @@ function slugify(name) {
   return slug;
 }
 
+// src/helpers/project-target.ts
+var IGNORABLE_ENTRIES = /* @__PURE__ */ new Set([
+  ".DS_Store",
+  ".git",
+  ".gitattributes",
+  ".gitignore",
+  ".gitlab-ci.yml",
+  ".hg",
+  ".hgcheck",
+  ".hgignore",
+  ".idea",
+  ".npmignore",
+  ".travis.yml",
+  ".vscode",
+  "LICENSE",
+  "LICENSE.md",
+  "LICENSE.txt",
+  "README.md",
+  "Thumbs.db"
+]);
+function isInPlaceTarget(target) {
+  const t = target.trim();
+  return t === "." || t === "./";
+}
+function resolveProjectTarget(target, cwd = process.cwd()) {
+  const trimmed = target.trim();
+  if (!trimmed) {
+    throw new Error("Project name is required.");
+  }
+  const inPlace = isInPlaceTarget(trimmed);
+  const outDir = path2.resolve(cwd, inPlace ? "." : trimmed);
+  const base = path2.basename(outDir);
+  const name = inPlace && (!base || base === "." || base === path2.sep) ? "app" : inPlace ? base : trimmed;
+  return {
+    outDir,
+    name,
+    slug: slugify(name),
+    inPlace
+  };
+}
+async function assertDirScaffoldable(outDir) {
+  if (!await fs.pathExists(outDir)) return;
+  const entries = await fs.readdir(outDir);
+  const blockers = entries.filter((entry) => !IGNORABLE_ENTRIES.has(entry));
+  if (blockers.length === 0) return;
+  throw new Error(
+    [
+      `Target directory is not empty: ${outDir}`,
+      `Conflicting entries: ${blockers.slice(0, 8).join(", ")}${blockers.length > 8 ? ", \u2026" : ""}`,
+      `Use an empty folder, or run with \`.\` only in a fresh directory (".git" / README / LICENSE are OK).`
+    ].join("\n")
+  );
+}
+
 // src/presets.ts
 var PRESET_SEEDS = {
   minimal: {
@@ -524,23 +582,27 @@ async function promptCustomOptions(base) {
 }
 async function runPrompts(initialName) {
   p.intro(color.bgCyan(color.black(` ${TITLE} `)));
-  const name = assertNotCancel(
+  const rawName = assertNotCancel(
     await p.text({
-      message: "Project name?",
+      message: "Project name? (use . for current directory)",
       placeholder: "my-app",
       initialValue: initialName ?? "my-app",
       validate(value) {
         const next = value ?? "";
         if (!next.trim()) return "Name is required.";
         try {
-          slugify(next);
+          resolveProjectTarget(next);
         } catch (error) {
           return error instanceof Error ? error.message : "Invalid name.";
         }
       }
     })
   );
-  const slug = slugify(name);
+  const target = resolveProjectTarget(rawName);
+  const { name, slug, outDir } = target;
+  if (target.inPlace) {
+    p.log.info(`Scaffolding into current directory \u2192 ${outDir}`);
+  }
   const packageManager = assertNotCancel(
     await p.select({
       message: "Package manager?",
@@ -603,6 +665,7 @@ async function runPrompts(initialName) {
   const draft = normalizeOptions({
     name: name.trim(),
     slug,
+    outDir,
     ...optionSeed,
     packageManager,
     noInstall: false
@@ -613,7 +676,7 @@ async function runPrompts(initialName) {
   }
   const confirmed = assertNotCancel(
     await p.confirm({
-      message: `Create ${color.cyan(name)} (${color.dim(slug)})?`,
+      message: target.inPlace ? `Create ${color.cyan(name)} (${color.dim(slug)}) in ${color.dim(".")}?` : `Create ${color.cyan(name)} (${color.dim(slug)})?`,
       initialValue: true
     })
   );
@@ -625,8 +688,8 @@ async function runPrompts(initialName) {
 }
 
 // src/scaffold.ts
-import fs28 from "fs-extra";
-import path29 from "path";
+import fs29 from "fs-extra";
+import path30 from "path";
 import { execFileSync } from "child_process";
 import * as p2 from "@clack/prompts";
 import color2 from "picocolors";
@@ -656,8 +719,8 @@ function yieldUi() {
 }
 
 // src/helpers/replace-tokens.ts
-import fs from "fs-extra";
-import path2 from "path";
+import fs2 from "fs-extra";
+import path3 from "path";
 var TEXT_EXT = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx",
@@ -681,9 +744,9 @@ var TEXT_EXT = /* @__PURE__ */ new Set([
   ".npmrc"
 ]);
 function shouldRewrite(filePath) {
-  const base = path2.basename(filePath);
+  const base = path3.basename(filePath);
   if (base === ".env.example" || base === "LICENSE") return true;
-  const ext = path2.extname(filePath);
+  const ext = path3.extname(filePath);
   return TEXT_EXT.has(ext) || base.startsWith(".");
 }
 function applyTokens(contents, tokens) {
@@ -694,26 +757,26 @@ function applyTokens(contents, tokens) {
   return out;
 }
 async function replaceTokensInTree(root, tokens) {
-  const entries = await fs.readdir(root, { withFileTypes: true });
+  const entries = await fs2.readdir(root, { withFileTypes: true });
   for (const entry of entries) {
-    const full = path2.join(root, entry.name);
+    const full = path3.join(root, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name === ".git") continue;
       await replaceTokensInTree(full, tokens);
       continue;
     }
     if (!shouldRewrite(full)) continue;
-    const raw = await fs.readFile(full, "utf8");
+    const raw = await fs2.readFile(full, "utf8");
     const next = applyTokens(raw, tokens);
     if (next !== raw) {
-      await fs.writeFile(full, next, "utf8");
+      await fs2.writeFile(full, next, "utf8");
     }
   }
 }
 
 // src/installers/api-envelope.ts
-import fs2 from "fs-extra";
-import path3 from "path";
+import fs3 from "fs-extra";
+import path4 from "path";
 var HTTP_ENVELOPE = `import { env } from "@/lib/env";
 
 type ApiEnvelope<T> = {
@@ -775,18 +838,18 @@ var apiEnvelopeInstaller = {
   id: "api-envelope",
   active: (o) => o.apiEnvelope,
   async run({ projectDir, options }) {
-    await fs2.writeFile(
-      path3.join(projectDir, "src", "lib", "http.ts"),
+    await fs3.writeFile(
+      path4.join(projectDir, "src", "lib", "http.ts"),
       HTTP_ENVELOPE,
       "utf8"
     );
-    await fs2.writeFile(
-      path3.join(projectDir, ".cursor", "rules", "api-envelope.mdc"),
+    await fs3.writeFile(
+      path4.join(projectDir, ".cursor", "rules", "api-envelope.mdc"),
       RULE,
       "utf8"
     );
-    await fs2.outputFile(
-      path3.join(projectDir, "docs", "style-guide", "http", "envelope.md"),
+    await fs3.outputFile(
+      path4.join(projectDir, "docs", "style-guide", "http", "envelope.md"),
       `# API envelope
 
 \`src/lib/http.ts\` \u2192 \`apiFetch\` unwraps \`result\` from standard envelopes.
@@ -797,8 +860,8 @@ ${options.endpoints ? "Endpoints/axios: use `unwrapApiResult` from `@/utils/api-
 };
 
 // src/helpers/app-providers.ts
-import fs3 from "fs-extra";
-import path4 from "path";
+import fs4 from "fs-extra";
+import path5 from "path";
 function needsAppProviders(options) {
   return options.data === "tanstack-query" || options.store === "redux" || options.styling === "mui" || options.i18n || options.darkMode;
 }
@@ -868,17 +931,17 @@ ${closers.join("\n")}
 }
 async function writeAppProviders(projectDir, options) {
   if (!needsAppProviders(options)) return;
-  const providersDir = path4.join(projectDir, "src", "providers");
-  await fs3.ensureDir(providersDir);
-  await fs3.remove(path4.join(providersDir, ".gitkeep"));
-  await fs3.writeFile(
-    path4.join(providersDir, "app-providers.tsx"),
+  const providersDir = path5.join(projectDir, "src", "providers");
+  await fs4.ensureDir(providersDir);
+  await fs4.remove(path5.join(providersDir, ".gitkeep"));
+  await fs4.writeFile(
+    path5.join(providersDir, "app-providers.tsx"),
     generateAppProvidersSource(options),
     "utf8"
   );
 }
 async function wireRootLayout(projectDir, options) {
-  const layoutPath = path4.join(projectDir, "src", "app", "layout.tsx");
+  const layoutPath = path5.join(projectDir, "src", "app", "layout.tsx");
   const useProviders = needsAppProviders(options);
   const dark = options.darkMode;
   const i18n = options.i18n;
@@ -937,8 +1000,8 @@ ${fnBody}
 }
 `;
   let final = source;
-  if (await fs3.pathExists(layoutPath)) {
-    const existing = await fs3.readFile(layoutPath, "utf8");
+  if (await fs4.pathExists(layoutPath)) {
+    const existing = await fs4.readFile(layoutPath, "utf8");
     const titleMatch = existing.match(/title:\s*"([^"]+)"/);
     if (titleMatch?.[1] && titleMatch[1] !== "__PROJECT_NAME__") {
       final = final.replace(
@@ -947,7 +1010,7 @@ ${fnBody}
       );
     }
   }
-  await fs3.writeFile(layoutPath, final, "utf8");
+  await fs4.writeFile(layoutPath, final, "utf8");
 }
 
 // src/installers/app-providers.ts
@@ -961,15 +1024,15 @@ var appProvidersInstaller = {
 };
 
 // src/installers/auth-authjs.ts
-import fs5 from "fs-extra";
-import path6 from "path";
+import fs6 from "fs-extra";
+import path7 from "path";
 
 // src/helpers/package-json.ts
-import fs4 from "fs-extra";
-import path5 from "path";
+import fs5 from "fs-extra";
+import path6 from "path";
 async function readPkg(projectDir) {
-  const pkgPath = path5.join(projectDir, "package.json");
-  const pkg = await fs4.readJson(pkgPath);
+  const pkgPath = path6.join(projectDir, "package.json");
+  const pkg = await fs5.readJson(pkgPath);
   return { pkgPath, pkg };
 }
 function sortRecord(record) {
@@ -983,7 +1046,7 @@ async function addDependencies(projectDir, deps, kind = "dependencies") {
     ...pkg[kind] ?? {},
     ...deps
   });
-  await fs4.writeJson(pkgPath, pkg, { spaces: 2 });
+  await fs5.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 async function addScripts(projectDir, scripts) {
   const { pkgPath, pkg } = await readPkg(projectDir);
@@ -991,12 +1054,12 @@ async function addScripts(projectDir, scripts) {
     ...pkg.scripts ?? {},
     ...scripts
   };
-  await fs4.writeJson(pkgPath, pkg, { spaces: 2 });
+  await fs5.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 async function mergePackageField(projectDir, field, value) {
   const { pkgPath, pkg } = await readPkg(projectDir);
   pkg[field] = value;
-  await fs4.writeJson(pkgPath, pkg, { spaces: 2 });
+  await fs5.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 async function removeDependencies(projectDir, names, kind = "dependencies") {
   const { pkgPath, pkg } = await readPkg(projectDir);
@@ -1005,7 +1068,7 @@ async function removeDependencies(projectDir, names, kind = "dependencies") {
     delete pkg[kind][name];
   }
   pkg[kind] = sortRecord(pkg[kind]);
-  await fs4.writeJson(pkgPath, pkg, { spaces: 2 });
+  await fs5.writeJson(pkgPath, pkg, { spaces: 2 });
 }
 
 // src/installers/auth-authjs.ts
@@ -1166,13 +1229,13 @@ var authAuthjsInstaller = {
   id: "auth-authjs",
   active: (o) => o.auth === "authjs",
   async run({ projectDir }) {
-    await fs5.writeFile(
-      path6.join(projectDir, "src", "lib", "auth.ts"),
+    await fs6.writeFile(
+      path7.join(projectDir, "src", "lib", "auth.ts"),
       AUTH_TS,
       "utf8"
     );
-    await fs5.outputFile(
-      path6.join(
+    await fs6.outputFile(
+      path7.join(
         projectDir,
         "src",
         "app",
@@ -1183,17 +1246,17 @@ var authAuthjsInstaller = {
       ),
       ROUTE
     );
-    await fs5.writeFile(
-      path6.join(projectDir, "src", "middleware.ts"),
+    await fs6.writeFile(
+      path7.join(projectDir, "src", "middleware.ts"),
       MIDDLEWARE,
       "utf8"
     );
-    await fs5.outputFile(
-      path6.join(projectDir, "src", "app", "login", "page.tsx"),
+    await fs6.outputFile(
+      path7.join(projectDir, "src", "app", "login", "page.tsx"),
       LOGIN_PAGE
     );
-    await fs5.outputFile(
-      path6.join(
+    await fs6.outputFile(
+      path7.join(
         projectDir,
         "src",
         "app",
@@ -1204,13 +1267,13 @@ var authAuthjsInstaller = {
       ),
       LOGIN_FORM
     );
-    await fs5.writeFile(
-      path6.join(projectDir, ".cursor", "rules", "auth.mdc"),
+    await fs6.writeFile(
+      path7.join(projectDir, ".cursor", "rules", "auth.mdc"),
       RULE2,
       "utf8"
     );
-    await fs5.outputFile(
-      path6.join(projectDir, "docs", "style-guide", "auth", "authjs.md"),
+    await fs6.outputFile(
+      path7.join(projectDir, "docs", "style-guide", "auth", "authjs.md"),
       `# Auth.js
 
 - \`src/lib/auth.ts\` \u2014 Credentials demo (replace \`authorize\`)
@@ -1220,15 +1283,15 @@ var authAuthjsInstaller = {
 - Env: \`AUTH_SECRET\`
 `
     );
-    const envPath = path6.join(projectDir, ".env.example");
-    if (await fs5.pathExists(envPath)) {
-      let env = await fs5.readFile(envPath, "utf8");
+    const envPath = path7.join(projectDir, ".env.example");
+    if (await fs6.pathExists(envPath)) {
+      let env = await fs6.readFile(envPath, "utf8");
       if (!env.includes("AUTH_SECRET")) {
         env += `
 # Auth.js \u2014 generate with: openssl rand -base64 32
 AUTH_SECRET=
 `;
-        await fs5.writeFile(envPath, env, "utf8");
+        await fs6.writeFile(envPath, env, "utf8");
       }
     }
     await addDependencies(projectDir, {
@@ -1238,8 +1301,8 @@ AUTH_SECRET=
 };
 
 // src/installers/auth-jwt.ts
-import fs6 from "fs-extra";
-import path7 from "path";
+import fs7 from "fs-extra";
+import path8 from "path";
 function tokenStorage(slug) {
   const accessKey = `${slug}.accessToken`;
   const refreshKey = `${slug}.refreshToken`;
@@ -1392,27 +1455,27 @@ var authJwtInstaller = {
   id: "auth-jwt",
   active: (o) => o.auth === "jwt",
   async run({ projectDir, options }) {
-    await fs6.ensureDir(path7.join(projectDir, "src", "utils"));
-    await fs6.remove(path7.join(projectDir, "src", "utils", ".gitkeep"));
-    await fs6.writeFile(
-      path7.join(projectDir, "src", "utils", "token-storage.ts"),
+    await fs7.ensureDir(path8.join(projectDir, "src", "utils"));
+    await fs7.remove(path8.join(projectDir, "src", "utils", ".gitkeep"));
+    await fs7.writeFile(
+      path8.join(projectDir, "src", "utils", "token-storage.ts"),
       tokenStorage(options.slug),
       "utf8"
     );
     if (options.endpoints) {
-      await fs6.writeFile(
-        path7.join(projectDir, "src", "utils", "axios-instance.ts"),
+      await fs7.writeFile(
+        path8.join(projectDir, "src", "utils", "axios-instance.ts"),
         AXIOS_JWT,
         "utf8"
       );
     }
-    await fs6.writeFile(
-      path7.join(projectDir, ".cursor", "rules", "auth.mdc"),
+    await fs7.writeFile(
+      path8.join(projectDir, ".cursor", "rules", "auth.mdc"),
       RULE3,
       "utf8"
     );
-    await fs6.outputFile(
-      path7.join(projectDir, "docs", "style-guide", "auth", "jwt.md"),
+    await fs7.outputFile(
+      path8.join(projectDir, "docs", "style-guide", "auth", "jwt.md"),
       `# JWT auth
 
 - \`src/utils/token-storage.ts\` \u2014 access/refresh in localStorage
@@ -1423,8 +1486,8 @@ var authJwtInstaller = {
 };
 
 // src/installers/ci.ts
-import fs7 from "fs-extra";
-import path8 from "path";
+import fs8 from "fs-extra";
+import path9 from "path";
 function workflowYaml(options) {
   const pm = getPackageManager(options.packageManager);
   const run = (script) => pm.runScript(script);
@@ -1502,25 +1565,25 @@ var ciInstaller = {
   id: "ci",
   active: (o) => o.ci,
   async run({ projectDir, options }) {
-    const addon = path8.join(ADDONS_DIR, "ci");
-    await fs7.outputFile(
-      path8.join(projectDir, ".github", "workflows", "ci.yml"),
+    const addon = path9.join(ADDONS_DIR, "ci");
+    await fs8.outputFile(
+      path9.join(projectDir, ".github", "workflows", "ci.yml"),
       workflowYaml(options)
     );
-    await fs7.copy(
-      path8.join(addon, ".cursor", "rules", "ci.mdc"),
-      path8.join(projectDir, ".cursor", "rules", "ci.mdc")
+    await fs8.copy(
+      path9.join(addon, ".cursor", "rules", "ci.mdc"),
+      path9.join(projectDir, ".cursor", "rules", "ci.mdc")
     );
-    await fs7.copy(
-      path8.join(addon, "docs", "style-guide", "ops", "ci.md"),
-      path8.join(projectDir, "docs", "style-guide", "ops", "ci.md")
+    await fs8.copy(
+      path9.join(addon, "docs", "style-guide", "ops", "ci.md"),
+      path9.join(projectDir, "docs", "style-guide", "ops", "ci.md")
     );
   }
 };
 
 // src/installers/dark-mode.ts
-import fs8 from "fs-extra";
-import path9 from "path";
+import fs9 from "fs-extra";
+import path10 from "path";
 var THEME_PROVIDER = `"use client";
 
 import { ThemeProvider as NextThemesProvider } from "next-themes";
@@ -1550,30 +1613,30 @@ var darkModeInstaller = {
   id: "dark-mode",
   active: (o) => o.darkMode && o.styling === "tailwind",
   async run({ projectDir }) {
-    const providersDir = path9.join(projectDir, "src", "providers");
-    await fs8.ensureDir(providersDir);
-    await fs8.remove(path9.join(providersDir, ".gitkeep"));
-    await fs8.writeFile(
-      path9.join(providersDir, "theme-provider.tsx"),
+    const providersDir = path10.join(projectDir, "src", "providers");
+    await fs9.ensureDir(providersDir);
+    await fs9.remove(path10.join(providersDir, ".gitkeep"));
+    await fs9.writeFile(
+      path10.join(providersDir, "theme-provider.tsx"),
       THEME_PROVIDER,
       "utf8"
     );
-    await fs8.writeFile(
-      path9.join(projectDir, ".cursor", "rules", "dark-mode.mdc"),
+    await fs9.writeFile(
+      path10.join(projectDir, ".cursor", "rules", "dark-mode.mdc"),
       RULE4,
       "utf8"
     );
-    await fs8.outputFile(
-      path9.join(projectDir, "docs", "style-guide", "ui", "dark-mode.md"),
+    await fs9.outputFile(
+      path10.join(projectDir, "docs", "style-guide", "ui", "dark-mode.md"),
       `# Dark mode
 
 next-themes + Tailwind \`dark:\` variants.
 Provider: \`src/providers/theme-provider.tsx\` (via \`AppProviders\`).
 `
     );
-    const globalsPath = path9.join(projectDir, "src", "app", "globals.css");
-    if (await fs8.pathExists(globalsPath)) {
-      let css = await fs8.readFile(globalsPath, "utf8");
+    const globalsPath = path10.join(projectDir, "src", "app", "globals.css");
+    if (await fs9.pathExists(globalsPath)) {
+      let css = await fs9.readFile(globalsPath, "utf8");
       if (!css.includes("@custom-variant dark")) {
         css = css.replace(
           `@import "tailwindcss";
@@ -1583,7 +1646,7 @@ Provider: \`src/providers/theme-provider.tsx\` (via \`AppProviders\`).
 @custom-variant dark (&:where(.dark, .dark *));
 `
         );
-        await fs8.writeFile(globalsPath, css, "utf8");
+        await fs9.writeFile(globalsPath, css, "utf8");
       }
     }
     await addDependencies(projectDir, {
@@ -1593,8 +1656,8 @@ Provider: \`src/providers/theme-provider.tsx\` (via \`AppProviders\`).
 };
 
 // src/installers/docker-compose.ts
-import fs9 from "fs-extra";
-import path10 from "path";
+import fs10 from "fs-extra";
+import path11 from "path";
 var COMPOSE = `services:
   api:
     image: nginx:alpine
@@ -1635,22 +1698,22 @@ var dockerComposeInstaller = {
   id: "docker-compose",
   active: (o) => o.auth === "jwt" && o.endpoints,
   async run({ projectDir }) {
-    await fs9.writeFile(
-      path10.join(projectDir, "docker-compose.yml"),
+    await fs10.writeFile(
+      path11.join(projectDir, "docker-compose.yml"),
       COMPOSE,
       "utf8"
     );
-    await fs9.outputFile(
-      path10.join(projectDir, "docker", "api-mock", "README.md"),
+    await fs10.outputFile(
+      path11.join(projectDir, "docker", "api-mock", "README.md"),
       MOCK_README
     );
-    await fs9.writeFile(
-      path10.join(projectDir, ".cursor", "rules", "docker-compose.mdc"),
+    await fs10.writeFile(
+      path11.join(projectDir, ".cursor", "rules", "docker-compose.mdc"),
       RULE5,
       "utf8"
     );
-    await fs9.outputFile(
-      path10.join(projectDir, "docs", "style-guide", "ops", "docker-compose.md"),
+    await fs10.outputFile(
+      path11.join(projectDir, "docs", "style-guide", "ops", "docker-compose.md"),
       `# Docker Compose (local API)
 
 \`\`\`bash
@@ -1664,8 +1727,8 @@ Stub listens on \`http://localhost:8000\`. Align with \`NEXT_PUBLIC_API_URL\`.
 };
 
 // src/installers/docker.ts
-import fs10 from "fs-extra";
-import path11 from "path";
+import fs11 from "fs-extra";
+import path12 from "path";
 var STANDALONE_CONFIG = `import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
@@ -1846,33 +1909,33 @@ var dockerInstaller = {
   id: "docker",
   active: (o) => o.deploy === "docker",
   async run({ projectDir, options }) {
-    const addon = path11.join(ADDONS_DIR, "docker");
+    const addon = path12.join(ADDONS_DIR, "docker");
     const pm = getPackageManager(options.packageManager);
-    await fs10.ensureDir(path11.join(projectDir, "docker"));
-    await fs10.writeFile(
-      path11.join(projectDir, "docker", "production.Dockerfile"),
+    await fs11.ensureDir(path12.join(projectDir, "docker"));
+    await fs11.writeFile(
+      path12.join(projectDir, "docker", "production.Dockerfile"),
       dockerfileFor(options.packageManager),
       "utf8"
     );
-    await fs10.copy(
-      path11.join(addon, ".dockerignore"),
-      path11.join(projectDir, ".dockerignore")
+    await fs11.copy(
+      path12.join(addon, ".dockerignore"),
+      path12.join(projectDir, ".dockerignore")
     );
-    await fs10.copy(
-      path11.join(addon, ".cursor", "rules", "docker.mdc"),
-      path11.join(projectDir, ".cursor", "rules", "docker.mdc")
+    await fs11.copy(
+      path12.join(addon, ".cursor", "rules", "docker.mdc"),
+      path12.join(projectDir, ".cursor", "rules", "docker.mdc")
     );
-    let doc = await fs10.readFile(
-      path11.join(addon, "docs", "style-guide", "ops", "docker.md"),
+    let doc = await fs11.readFile(
+      path12.join(addon, "docs", "style-guide", "ops", "docker.md"),
       "utf8"
     );
     doc = doc.replaceAll("__PROJECT_SLUG__", options.slug).replaceAll("__PACKAGE_MANAGER__", pm.id);
-    await fs10.outputFile(
-      path11.join(projectDir, "docs", "style-guide", "ops", "docker.md"),
+    await fs11.outputFile(
+      path12.join(projectDir, "docs", "style-guide", "ops", "docker.md"),
       doc
     );
-    await fs10.writeFile(
-      path11.join(projectDir, "next.config.ts"),
+    await fs11.writeFile(
+      path12.join(projectDir, "next.config.ts"),
       STANDALONE_CONFIG,
       "utf8"
     );
@@ -1880,20 +1943,20 @@ var dockerInstaller = {
 };
 
 // src/installers/endpoints.ts
-import fs11 from "fs-extra";
-import path12 from "path";
+import fs12 from "fs-extra";
+import path13 from "path";
 var endpointsInstaller = {
   id: "endpoints",
   active: (o) => o.endpoints,
   async run({ projectDir }) {
-    const addon = path12.join(ADDONS_DIR, "endpoints");
-    await fs11.copy(
-      path12.join(addon, "scripts"),
-      path12.join(projectDir, "scripts")
+    const addon = path13.join(ADDONS_DIR, "endpoints");
+    await fs12.copy(
+      path13.join(addon, "scripts"),
+      path13.join(projectDir, "scripts")
     );
-    await fs11.copy(
-      path12.join(addon, "src", "endpoints"),
-      path12.join(projectDir, "src", "endpoints")
+    await fs12.copy(
+      path13.join(addon, "src", "endpoints"),
+      path13.join(projectDir, "src", "endpoints")
     );
     for (const file of [
       "axios-instance.ts",
@@ -1902,19 +1965,19 @@ var endpointsInstaller = {
       "search-params.ts",
       "form-data.ts"
     ]) {
-      await fs11.copy(
-        path12.join(addon, "src", "utils", file),
-        path12.join(projectDir, "src", "utils", file)
+      await fs12.copy(
+        path13.join(addon, "src", "utils", file),
+        path13.join(projectDir, "src", "utils", file)
       );
     }
-    await fs11.remove(path12.join(projectDir, "src", "utils", ".gitkeep"));
-    await fs11.copy(
-      path12.join(addon, ".cursor", "rules", "endpoints.mdc"),
-      path12.join(projectDir, ".cursor", "rules", "endpoints.mdc")
+    await fs12.remove(path13.join(projectDir, "src", "utils", ".gitkeep"));
+    await fs12.copy(
+      path13.join(addon, ".cursor", "rules", "endpoints.mdc"),
+      path13.join(projectDir, ".cursor", "rules", "endpoints.mdc")
     );
-    await fs11.copy(
-      path12.join(addon, "docs", "style-guide", "http", "endpoints.md"),
-      path12.join(projectDir, "docs", "style-guide", "http", "endpoints.md")
+    await fs12.copy(
+      path13.join(addon, "docs", "style-guide", "http", "endpoints.md"),
+      path13.join(projectDir, "docs", "style-guide", "http", "endpoints.md")
     );
     await addDependencies(projectDir, { axios: "^1.7.9" });
     await addDependencies(
@@ -1929,24 +1992,24 @@ var endpointsInstaller = {
 };
 
 // src/installers/eslint.ts
-import fs12 from "fs-extra";
-import path13 from "path";
+import fs13 from "fs-extra";
+import path14 from "path";
 var eslintInstaller = {
   id: "eslint",
   active: (o) => o.eslint,
   async run({ projectDir }) {
-    const addon = path13.join(ADDONS_DIR, "eslint");
-    await fs12.copy(
-      path13.join(addon, "eslint.config.mjs"),
-      path13.join(projectDir, "eslint.config.mjs")
+    const addon = path14.join(ADDONS_DIR, "eslint");
+    await fs13.copy(
+      path14.join(addon, "eslint.config.mjs"),
+      path14.join(projectDir, "eslint.config.mjs")
     );
-    await fs12.copy(
-      path13.join(addon, ".cursor", "rules", "eslint.mdc"),
-      path13.join(projectDir, ".cursor", "rules", "eslint.mdc")
+    await fs13.copy(
+      path14.join(addon, ".cursor", "rules", "eslint.mdc"),
+      path14.join(projectDir, ".cursor", "rules", "eslint.mdc")
     );
-    await fs12.copy(
-      path13.join(addon, "docs", "style-guide", "tooling", "eslint.md"),
-      path13.join(projectDir, "docs", "style-guide", "tooling", "eslint.md")
+    await fs13.copy(
+      path14.join(addon, "docs", "style-guide", "tooling", "eslint.md"),
+      path14.join(projectDir, "docs", "style-guide", "tooling", "eslint.md")
     );
     await addDependencies(
       projectDir,
@@ -1965,20 +2028,20 @@ var eslintInstaller = {
 };
 
 // src/installers/husky.ts
-import fs13 from "fs-extra";
-import path14 from "path";
+import fs14 from "fs-extra";
+import path15 from "path";
 var huskyInstaller = {
   id: "husky",
   active: (o) => o.husky,
   async run({ projectDir, options }) {
-    const addon = path14.join(ADDONS_DIR, "husky");
-    await fs13.copy(path14.join(addon, ".husky"), path14.join(projectDir, ".husky"));
-    await fs13.copy(
-      path14.join(addon, "docs", "style-guide", "tooling", "husky.md"),
-      path14.join(projectDir, "docs", "style-guide", "tooling", "husky.md")
+    const addon = path15.join(ADDONS_DIR, "husky");
+    await fs14.copy(path15.join(addon, ".husky"), path15.join(projectDir, ".husky"));
+    await fs14.copy(
+      path15.join(addon, "docs", "style-guide", "tooling", "husky.md"),
+      path15.join(projectDir, "docs", "style-guide", "tooling", "husky.md")
     );
     try {
-      await fs13.chmod(path14.join(projectDir, ".husky", "pre-commit"), 493);
+      await fs14.chmod(path15.join(projectDir, ".husky", "pre-commit"), 493);
     } catch {
     }
     await addDependencies(
@@ -2005,8 +2068,8 @@ var huskyInstaller = {
 };
 
 // src/installers/i18n.ts
-import fs14 from "fs-extra";
-import path15 from "path";
+import fs15 from "fs-extra";
+import path16 from "path";
 var I18N_REQUEST = `import { getRequestConfig } from "next-intl/server";
 
 export default getRequestConfig(async () => {
@@ -2041,30 +2104,30 @@ var i18nInstaller = {
   id: "i18n",
   active: (o) => o.i18n,
   async run({ projectDir }) {
-    await fs14.outputFile(
-      path15.join(projectDir, "src", "i18n", "request.ts"),
+    await fs15.outputFile(
+      path16.join(projectDir, "src", "i18n", "request.ts"),
       I18N_REQUEST
     );
-    await fs14.outputFile(
-      path15.join(projectDir, "messages", "en.json"),
+    await fs15.outputFile(
+      path16.join(projectDir, "messages", "en.json"),
       MESSAGES_EN
     );
-    await fs14.writeFile(
-      path15.join(projectDir, ".cursor", "rules", "i18n.mdc"),
+    await fs15.writeFile(
+      path16.join(projectDir, ".cursor", "rules", "i18n.mdc"),
       RULE6,
       "utf8"
     );
-    await fs14.outputFile(
-      path15.join(projectDir, "docs", "style-guide", "i18n", "overview.md"),
+    await fs15.outputFile(
+      path16.join(projectDir, "docs", "style-guide", "i18n", "overview.md"),
       `# i18n
 
 next-intl: \`src/i18n/request.ts\` + \`messages/en.json\`
 Plugin wired in \`next.config.ts\`. Provider via \`AppProviders\`.
 `
     );
-    const nextConfigPath = path15.join(projectDir, "next.config.ts");
-    if (await fs14.pathExists(nextConfigPath)) {
-      let nextConfig = await fs14.readFile(nextConfigPath, "utf8");
+    const nextConfigPath = path16.join(projectDir, "next.config.ts");
+    if (await fs15.pathExists(nextConfigPath)) {
+      let nextConfig = await fs15.readFile(nextConfigPath, "utf8");
       if (!nextConfig.includes("next-intl")) {
         if (!nextConfig.includes("createNextIntlPlugin")) {
           nextConfig = `import createNextIntlPlugin from "next-intl/plugin";
@@ -2077,7 +2140,7 @@ ${nextConfig}`;
           "export default nextConfig;",
           "export default withNextIntl(nextConfig);"
         );
-        await fs14.writeFile(nextConfigPath, nextConfig, "utf8");
+        await fs15.writeFile(nextConfigPath, nextConfig, "utf8");
       }
     }
     await addDependencies(projectDir, {
@@ -2087,8 +2150,8 @@ ${nextConfig}`;
 };
 
 // src/installers/icons.ts
-import fs15 from "fs-extra";
-import path16 from "path";
+import fs16 from "fs-extra";
+import path17 from "path";
 var RULE7 = `---
 description: Icon library conventions
 globs: "src/**/*.{ts,tsx}"
@@ -2112,10 +2175,10 @@ var iconsInstaller = {
     if (options.icons === "none") return;
     const pkg = ICON_PACKAGES[options.icons];
     await addDependencies(projectDir, { [pkg.name]: pkg.version });
-    const ruleDir = path16.join(projectDir, ".cursor", "rules");
-    await fs15.ensureDir(ruleDir);
-    await fs15.writeFile(
-      path16.join(ruleDir, "icons.mdc"),
+    const ruleDir = path17.join(projectDir, ".cursor", "rules");
+    await fs16.ensureDir(ruleDir);
+    await fs16.writeFile(
+      path17.join(ruleDir, "icons.mdc"),
       RULE7.replace("__ICONS_BODY__", BODIES[options.icons]),
       "utf8"
     );
@@ -2123,8 +2186,8 @@ var iconsInstaller = {
 };
 
 // src/installers/mui.ts
-import fs16 from "fs-extra";
-import path17 from "path";
+import fs17 from "fs-extra";
+import path18 from "path";
 var THEME_PROVIDER2 = `"use client";
 
 import { type ReactNode } from "react";
@@ -2168,16 +2231,16 @@ var muiInstaller = {
   id: "mui",
   active: (o) => o.styling === "mui",
   async run({ projectDir }) {
-    const providersDir = path17.join(projectDir, "src", "providers");
-    await fs16.ensureDir(providersDir);
-    await fs16.remove(path17.join(providersDir, ".gitkeep"));
-    await fs16.writeFile(
-      path17.join(providersDir, "mui-provider.tsx"),
+    const providersDir = path18.join(projectDir, "src", "providers");
+    await fs17.ensureDir(providersDir);
+    await fs17.remove(path18.join(providersDir, ".gitkeep"));
+    await fs17.writeFile(
+      path18.join(providersDir, "mui-provider.tsx"),
       THEME_PROVIDER2,
       "utf8"
     );
-    await fs16.writeFile(
-      path17.join(projectDir, ".cursor", "rules", "mui.mdc"),
+    await fs17.writeFile(
+      path18.join(projectDir, ".cursor", "rules", "mui.mdc"),
       RULE8,
       "utf8"
     );
@@ -2192,43 +2255,43 @@ var muiInstaller = {
 };
 
 // src/installers/package-manager.ts
-import fs17 from "fs-extra";
-import path18 from "path";
+import fs18 from "fs-extra";
+import path19 from "path";
 var packageManagerInstaller = {
   id: "package-manager",
   active: () => true,
   async run({ projectDir, options }) {
     const meta = getPackageManager(options.packageManager);
-    const pkgPath = path18.join(projectDir, "package.json");
-    const pkg = await fs17.readJson(pkgPath);
+    const pkgPath = path19.join(projectDir, "package.json");
+    const pkg = await fs18.readJson(pkgPath);
     if (meta.packageManagerField) {
       pkg.packageManager = meta.packageManagerField;
     } else {
       delete pkg.packageManager;
     }
-    await fs17.writeJson(pkgPath, pkg, { spaces: 2 });
+    await fs18.writeJson(pkgPath, pkg, { spaces: 2 });
   }
 };
 
 // src/installers/prettier.ts
-import fs18 from "fs-extra";
-import path19 from "path";
+import fs19 from "fs-extra";
+import path20 from "path";
 var prettierInstaller = {
   id: "prettier",
   active: (o) => o.prettier,
   async run({ projectDir }) {
-    const addon = path19.join(ADDONS_DIR, "prettier");
-    await fs18.copy(
-      path19.join(addon, ".prettierrc"),
-      path19.join(projectDir, ".prettierrc")
+    const addon = path20.join(ADDONS_DIR, "prettier");
+    await fs19.copy(
+      path20.join(addon, ".prettierrc"),
+      path20.join(projectDir, ".prettierrc")
     );
-    await fs18.copy(
-      path19.join(addon, ".cursor", "rules", "prettier.mdc"),
-      path19.join(projectDir, ".cursor", "rules", "prettier.mdc")
+    await fs19.copy(
+      path20.join(addon, ".cursor", "rules", "prettier.mdc"),
+      path20.join(projectDir, ".cursor", "rules", "prettier.mdc")
     );
-    await fs18.copy(
-      path19.join(addon, "docs", "style-guide", "tooling", "prettier.md"),
-      path19.join(projectDir, "docs", "style-guide", "tooling", "prettier.md")
+    await fs19.copy(
+      path20.join(addon, "docs", "style-guide", "tooling", "prettier.md"),
+      path20.join(projectDir, "docs", "style-guide", "tooling", "prettier.md")
     );
     await addDependencies(
       projectDir,
@@ -2243,8 +2306,8 @@ var prettierInstaller = {
 };
 
 // src/installers/seo.ts
-import fs19 from "fs-extra";
-import path20 from "path";
+import fs20 from "fs-extra";
+import path21 from "path";
 var SEO_TS = `import type { Metadata } from "next";
 
 import { env } from "@/lib/env";
@@ -2393,29 +2456,29 @@ var seoInstaller = {
   active: (o) => o.seo,
   async run({ projectDir, options }) {
     let seo = SEO_TS.replaceAll("__PROJECT_NAME__", options.name);
-    await fs19.writeFile(path20.join(projectDir, "src", "lib", "seo.ts"), seo, "utf8");
-    await fs19.writeFile(
-      path20.join(projectDir, "src", "lib", "public-routes.ts"),
+    await fs20.writeFile(path21.join(projectDir, "src", "lib", "seo.ts"), seo, "utf8");
+    await fs20.writeFile(
+      path21.join(projectDir, "src", "lib", "public-routes.ts"),
       PUBLIC_ROUTES,
       "utf8"
     );
-    await fs19.writeFile(
-      path20.join(projectDir, "src", "app", "sitemap.ts"),
+    await fs20.writeFile(
+      path21.join(projectDir, "src", "app", "sitemap.ts"),
       SITEMAP,
       "utf8"
     );
-    await fs19.writeFile(
-      path20.join(projectDir, "src", "app", "robots.ts"),
+    await fs20.writeFile(
+      path21.join(projectDir, "src", "app", "robots.ts"),
       ROBOTS,
       "utf8"
     );
-    await fs19.writeFile(
-      path20.join(projectDir, ".cursor", "rules", "seo.mdc"),
+    await fs20.writeFile(
+      path21.join(projectDir, ".cursor", "rules", "seo.mdc"),
       RULE9,
       "utf8"
     );
-    await fs19.outputFile(
-      path20.join(projectDir, "docs", "style-guide", "seo", "overview.md"),
+    await fs20.outputFile(
+      path21.join(projectDir, "docs", "style-guide", "seo", "overview.md"),
       `# SEO
 
 - Registry: \`src/lib/public-routes.ts\`
@@ -2429,8 +2492,8 @@ Add a page \u2192 register the path \u2192 metadata/sitemap update automatically
 };
 
 // src/installers/shadcn.ts
-import fs20 from "fs-extra";
-import path21 from "path";
+import fs21 from "fs-extra";
+import path22 from "path";
 function componentsJson(iconLibrary) {
   return `${JSON.stringify(
     {
@@ -2665,28 +2728,28 @@ var shadcnInstaller = {
   async run({ projectDir, options }) {
     const iconLibrary = options.icons === "tabler" ? "tabler" : "lucide";
     const set = options.shadcnSet;
-    const uiDir = path21.join(projectDir, "src", "components", "ui");
-    await fs20.writeFile(
-      path21.join(projectDir, "components.json"),
+    const uiDir = path22.join(projectDir, "src", "components", "ui");
+    await fs21.writeFile(
+      path22.join(projectDir, "components.json"),
       componentsJson(iconLibrary),
       "utf8"
     );
-    await fs20.ensureDir(uiDir);
-    await fs20.writeFile(path21.join(uiDir, "button.tsx"), BUTTON, "utf8");
+    await fs21.ensureDir(uiDir);
+    await fs21.writeFile(path22.join(uiDir, "button.tsx"), BUTTON, "utf8");
     if (set === "starter") {
-      await fs20.writeFile(path21.join(uiDir, "input.tsx"), INPUT, "utf8");
-      await fs20.writeFile(path21.join(uiDir, "card.tsx"), CARD, "utf8");
-      await fs20.writeFile(path21.join(uiDir, "dialog.tsx"), DIALOG, "utf8");
+      await fs21.writeFile(path22.join(uiDir, "input.tsx"), INPUT, "utf8");
+      await fs21.writeFile(path22.join(uiDir, "card.tsx"), CARD, "utf8");
+      await fs21.writeFile(path22.join(uiDir, "dialog.tsx"), DIALOG, "utf8");
     }
-    await fs20.remove(path21.join(uiDir, ".gitkeep"));
-    await fs20.remove(path21.join(projectDir, "src", "components", ".gitkeep"));
-    await fs20.writeFile(
-      path21.join(projectDir, ".cursor", "rules", "shadcn.mdc"),
+    await fs21.remove(path22.join(uiDir, ".gitkeep"));
+    await fs21.remove(path22.join(projectDir, "src", "components", ".gitkeep"));
+    await fs21.writeFile(
+      path22.join(projectDir, ".cursor", "rules", "shadcn.mdc"),
       ruleFor(set),
       "utf8"
     );
-    await fs20.outputFile(
-      path21.join(projectDir, "docs", "style-guide", "ui", "shadcn.md"),
+    await fs21.outputFile(
+      path22.join(projectDir, "docs", "style-guide", "ui", "shadcn.md"),
       `# shadcn/ui
 
 Set: **${set}**
@@ -2710,8 +2773,8 @@ Add more: \`npx shadcn@latest add \u2026\`
 };
 
 // src/installers/store.ts
-import fs21 from "fs-extra";
-import path22 from "path";
+import fs22 from "fs-extra";
+import path23 from "path";
 var ZUSTAND_STORE = `import { create } from "zustand";
 
 type AppState = {
@@ -2812,21 +2875,21 @@ var storeInstaller = {
   id: "store",
   active: (o) => o.store !== "none",
   async run({ projectDir, options }) {
-    const storesDir = path22.join(projectDir, "src", "stores");
-    await fs21.ensureDir(storesDir);
+    const storesDir = path23.join(projectDir, "src", "stores");
+    await fs22.ensureDir(storesDir);
     if (options.store === "zustand") {
-      await fs21.writeFile(
-        path22.join(storesDir, "app-store.ts"),
+      await fs22.writeFile(
+        path23.join(storesDir, "app-store.ts"),
         ZUSTAND_STORE,
         "utf8"
       );
-      await fs21.writeFile(
-        path22.join(projectDir, ".cursor", "rules", "store.mdc"),
+      await fs22.writeFile(
+        path23.join(projectDir, ".cursor", "rules", "store.mdc"),
         ZUSTAND_RULE,
         "utf8"
       );
-      await fs21.outputFile(
-        path22.join(projectDir, "docs", "style-guide", "state", "zustand.md"),
+      await fs22.outputFile(
+        path23.join(projectDir, "docs", "style-guide", "state", "zustand.md"),
         `# Zustand
 
 - Store: \`src/stores/app-store.ts\`
@@ -2836,23 +2899,23 @@ var storeInstaller = {
       await addDependencies(projectDir, { zustand: "^5.0.3" });
       return;
     }
-    await fs21.writeFile(path22.join(storesDir, "store.ts"), REDUX_STORE, "utf8");
-    await fs21.writeFile(path22.join(storesDir, "hooks.ts"), REDUX_HOOKS, "utf8");
-    const providersDir = path22.join(projectDir, "src", "providers");
-    await fs21.ensureDir(providersDir);
-    await fs21.remove(path22.join(providersDir, ".gitkeep"));
-    await fs21.writeFile(
-      path22.join(providersDir, "store-provider.tsx"),
+    await fs22.writeFile(path23.join(storesDir, "store.ts"), REDUX_STORE, "utf8");
+    await fs22.writeFile(path23.join(storesDir, "hooks.ts"), REDUX_HOOKS, "utf8");
+    const providersDir = path23.join(projectDir, "src", "providers");
+    await fs22.ensureDir(providersDir);
+    await fs22.remove(path23.join(providersDir, ".gitkeep"));
+    await fs22.writeFile(
+      path23.join(providersDir, "store-provider.tsx"),
       REDUX_PROVIDER,
       "utf8"
     );
-    await fs21.writeFile(
-      path22.join(projectDir, ".cursor", "rules", "store.mdc"),
+    await fs22.writeFile(
+      path23.join(projectDir, ".cursor", "rules", "store.mdc"),
       REDUX_RULE,
       "utf8"
     );
-    await fs21.outputFile(
-      path22.join(projectDir, "docs", "style-guide", "state", "redux.md"),
+    await fs22.outputFile(
+      path23.join(projectDir, "docs", "style-guide", "state", "redux.md"),
       `# Redux Toolkit
 
 - Store: \`src/stores/store.ts\`
@@ -2868,8 +2931,8 @@ var storeInstaller = {
 };
 
 // src/installers/surface.ts
-import fs22 from "fs-extra";
-import path23 from "path";
+import fs23 from "fs-extra";
+import path24 from "path";
 function stackLines(options) {
   const stylingLabel = options.styling === "tailwind" ? options.ui === "shadcn" ? "Tailwind + shadcn/ui" : "Tailwind CSS" : options.styling === "mui" ? "MUI" : "Plain CSS";
   return [
@@ -3054,8 +3117,8 @@ var surfaceInstaller = {
   id: "surface",
   active: () => true,
   async run({ projectDir, options }) {
-    await fs22.writeFile(
-      path23.join(
+    await fs23.writeFile(
+      path24.join(
         projectDir,
         "src",
         "app",
@@ -3066,15 +3129,15 @@ var surfaceInstaller = {
       welcomeCardSource(options),
       "utf8"
     );
-    await fs22.writeFile(
-      path23.join(projectDir, "src", "app", "page.tsx"),
+    await fs23.writeFile(
+      path24.join(projectDir, "src", "app", "page.tsx"),
       homePageSource(options),
       "utf8"
     );
     if (options.data === "tanstack-query") {
-      await fs22.copy(
-        path23.join(ADDONS_DIR, "docs", "data", "tanstack-query.md"),
-        path23.join(
+      await fs23.copy(
+        path24.join(ADDONS_DIR, "docs", "data", "tanstack-query.md"),
+        path24.join(
           projectDir,
           "docs",
           "style-guide",
@@ -3084,27 +3147,27 @@ var surfaceInstaller = {
       );
     }
     if (options.icons !== "none") {
-      await fs22.copy(
-        path23.join(ADDONS_DIR, "docs", "ui", "icons.md"),
-        path23.join(projectDir, "docs", "style-guide", "ui", "icons.md")
+      await fs23.copy(
+        path24.join(ADDONS_DIR, "docs", "ui", "icons.md"),
+        path24.join(projectDir, "docs", "style-guide", "ui", "icons.md")
       );
     }
     if (options.auth === "jwt" && options.endpoints) {
-      const exampleSrc = path23.join(
+      const exampleSrc = path24.join(
         ADDONS_DIR,
         "docs",
         "examples",
         "api-app-crud.md"
       );
-      if (await fs22.pathExists(exampleSrc)) {
-        await fs22.copy(
+      if (await fs23.pathExists(exampleSrc)) {
+        await fs23.copy(
           exampleSrc,
-          path23.join(projectDir, "docs", "examples", "api-app-crud.md")
+          path24.join(projectDir, "docs", "examples", "api-app-crud.md")
         );
       }
     }
-    await fs22.writeFile(
-      path23.join(projectDir, "docs", "style-guide", "README.md"),
+    await fs23.writeFile(
+      path24.join(projectDir, "docs", "style-guide", "README.md"),
       docsIndex(options),
       "utf8"
     );
@@ -3112,8 +3175,8 @@ var surfaceInstaller = {
 };
 
 // src/installers/tailwind.ts
-import fs23 from "fs-extra";
-import path24 from "path";
+import fs24 from "fs-extra";
+import path25 from "path";
 var POSTCSS = `const config = {
   plugins: {
     "@tailwindcss/postcss": {},
@@ -3239,23 +3302,23 @@ var tailwindInstaller = {
   id: "tailwind",
   active: (o) => o.styling === "tailwind",
   async run({ projectDir }) {
-    await fs23.writeFile(
-      path24.join(projectDir, "postcss.config.mjs"),
+    await fs24.writeFile(
+      path25.join(projectDir, "postcss.config.mjs"),
       POSTCSS,
       "utf8"
     );
-    await fs23.writeFile(
-      path24.join(projectDir, "src", "app", "globals.css"),
+    await fs24.writeFile(
+      path25.join(projectDir, "src", "app", "globals.css"),
       GLOBALS,
       "utf8"
     );
-    await fs23.writeFile(
-      path24.join(projectDir, "src", "lib", "utils.ts"),
+    await fs24.writeFile(
+      path25.join(projectDir, "src", "lib", "utils.ts"),
       UTILS,
       "utf8"
     );
-    await fs23.writeFile(
-      path24.join(projectDir, ".cursor", "rules", "tailwind.mdc"),
+    await fs24.writeFile(
+      path25.join(projectDir, ".cursor", "rules", "tailwind.mdc"),
       RULE10,
       "utf8"
     );
@@ -3275,8 +3338,8 @@ var tailwindInstaller = {
 };
 
 // src/installers/tanstack-query.ts
-import fs24 from "fs-extra";
-import path25 from "path";
+import fs25 from "fs-extra";
+import path26 from "path";
 var PROVIDER = `"use client";
 
 import { type ReactNode, useState } from "react";
@@ -3325,18 +3388,18 @@ var tanstackQueryInstaller = {
     await addDependencies(projectDir, {
       "@tanstack/react-query": "^5.62.8"
     });
-    const providersDir = path25.join(projectDir, "src", "providers");
-    await fs24.ensureDir(providersDir);
-    await fs24.remove(path25.join(providersDir, ".gitkeep"));
-    await fs24.writeFile(
-      path25.join(providersDir, "query-provider.tsx"),
+    const providersDir = path26.join(projectDir, "src", "providers");
+    await fs25.ensureDir(providersDir);
+    await fs25.remove(path26.join(providersDir, ".gitkeep"));
+    await fs25.writeFile(
+      path26.join(providersDir, "query-provider.tsx"),
       PROVIDER,
       "utf8"
     );
-    const ruleDir = path25.join(projectDir, ".cursor", "rules");
-    await fs24.ensureDir(ruleDir);
-    await fs24.writeFile(
-      path25.join(ruleDir, "tanstack-query.mdc"),
+    const ruleDir = path26.join(projectDir, ".cursor", "rules");
+    await fs25.ensureDir(ruleDir);
+    await fs25.writeFile(
+      path26.join(ruleDir, "tanstack-query.mdc"),
       RULE11,
       "utf8"
     );
@@ -3344,8 +3407,8 @@ var tanstackQueryInstaller = {
 };
 
 // src/installers/testing.ts
-import fs25 from "fs-extra";
-import path26 from "path";
+import fs26 from "fs-extra";
+import path27 from "path";
 var VITEST_CONFIG = `import react from "@vitejs/plugin-react";
 import { resolve } from "node:path";
 import { defineConfig } from "vitest/config";
@@ -3423,13 +3486,13 @@ alwaysApply: false
 - Prefer \`renderToStaticMarkup\` for simple server component smoke.
 - Run \`${testCmd}\`. Playwright (if enabled): \`${e2eCmd}\`.
 `;
-    await fs25.writeFile(
-      path26.join(projectDir, "vitest.config.mts"),
+    await fs26.writeFile(
+      path27.join(projectDir, "vitest.config.mts"),
       VITEST_CONFIG,
       "utf8"
     );
-    await fs25.outputFile(
-      path26.join(
+    await fs26.outputFile(
+      path27.join(
         projectDir,
         "src",
         "app",
@@ -3439,13 +3502,13 @@ alwaysApply: false
       ),
       SAMPLE_TEST
     );
-    await fs25.writeFile(
-      path26.join(projectDir, ".cursor", "rules", "testing.mdc"),
+    await fs26.writeFile(
+      path27.join(projectDir, ".cursor", "rules", "testing.mdc"),
       rule,
       "utf8"
     );
-    await fs25.outputFile(
-      path26.join(projectDir, "docs", "style-guide", "tooling", "testing.md"),
+    await fs26.outputFile(
+      path27.join(projectDir, "docs", "style-guide", "tooling", "testing.md"),
       `# Testing
 
 Vitest: \`${testCmd}\`
@@ -3470,12 +3533,12 @@ Playwright: \`${e2eCmd}\` \xB7 config \`playwright.config.ts\` \xB7 specs in \`e
       "test:watch": "vitest"
     });
     if (options.playwright) {
-      await fs25.writeFile(
-        path26.join(projectDir, "playwright.config.ts"),
+      await fs26.writeFile(
+        path27.join(projectDir, "playwright.config.ts"),
         playwrightConfig(pm.runScript("dev")),
         "utf8"
       );
-      await fs25.outputFile(path26.join(projectDir, "e2e", "home.spec.ts"), E2E_SMOKE);
+      await fs26.outputFile(path27.join(projectDir, "e2e", "home.spec.ts"), E2E_SMOKE);
       await addDependencies(
         projectDir,
         { "@playwright/test": "^1.50.1" },
@@ -3489,8 +3552,8 @@ Playwright: \`${e2eCmd}\` \xB7 config \`playwright.config.ts\` \xB7 specs in \`e
 };
 
 // src/installers/validation.ts
-import fs26 from "fs-extra";
-import path27 from "path";
+import fs27 from "fs-extra";
+import path28 from "path";
 var ENV_ZOD = `import { z } from "zod";
 
 /**
@@ -3572,37 +3635,37 @@ var validationInstaller = {
   id: "validation",
   active: () => true,
   async run({ projectDir, options }) {
-    const validationsDir = path27.join(projectDir, "src", "lib", "validations");
-    await fs26.ensureDir(validationsDir);
-    await fs26.writeFile(path27.join(validationsDir, ".gitkeep"), "", "utf8");
+    const validationsDir = path28.join(projectDir, "src", "lib", "validations");
+    await fs27.ensureDir(validationsDir);
+    await fs27.writeFile(path28.join(validationsDir, ".gitkeep"), "", "utf8");
     if (options.validation === "yup") {
-      await fs26.writeFile(
-        path27.join(projectDir, "src", "lib", "env.ts"),
+      await fs27.writeFile(
+        path28.join(projectDir, "src", "lib", "env.ts"),
         ENV_YUP,
         "utf8"
       );
       await removeDependencies(projectDir, ["zod"]);
       await addDependencies(projectDir, { yup: "^1.6.1" });
     } else {
-      await fs26.writeFile(
-        path27.join(projectDir, "src", "lib", "env.ts"),
+      await fs27.writeFile(
+        path28.join(projectDir, "src", "lib", "env.ts"),
         ENV_ZOD,
         "utf8"
       );
       await addDependencies(projectDir, { zod: "^3.24.1" });
     }
-    await fs26.writeFile(
-      path27.join(projectDir, ".cursor", "rules", "forms.mdc"),
+    await fs27.writeFile(
+      path28.join(projectDir, ".cursor", "rules", "forms.mdc"),
       formsRule(options.validation),
       "utf8"
     );
-    await fs26.writeFile(
-      path27.join(projectDir, ".cursor", "rules", "validation.mdc"),
+    await fs27.writeFile(
+      path28.join(projectDir, ".cursor", "rules", "validation.mdc"),
       validationRule(options.validation),
       "utf8"
     );
-    await fs26.outputFile(
-      path27.join(
+    await fs27.outputFile(
+      path28.join(
         projectDir,
         "docs",
         "style-guide",
@@ -3620,8 +3683,8 @@ Forms: \`@hookform/resolvers/${options.validation}\` when using RHF.
 };
 
 // src/installers/vercel.ts
-import fs27 from "fs-extra";
-import path28 from "path";
+import fs28 from "fs-extra";
+import path29 from "path";
 var VERCEL_JSON = `{
   "framework": "nextjs",
   "regions": ["iad1"]
@@ -3644,18 +3707,18 @@ var vercelInstaller = {
   id: "vercel",
   active: (o) => o.deploy === "vercel",
   async run({ projectDir }) {
-    await fs27.writeFile(
-      path28.join(projectDir, "vercel.json"),
+    await fs28.writeFile(
+      path29.join(projectDir, "vercel.json"),
       VERCEL_JSON,
       "utf8"
     );
-    await fs27.writeFile(
-      path28.join(projectDir, ".cursor", "rules", "vercel.mdc"),
+    await fs28.writeFile(
+      path29.join(projectDir, ".cursor", "rules", "vercel.mdc"),
       RULE12,
       "utf8"
     );
-    await fs27.outputFile(
-      path28.join(projectDir, "docs", "style-guide", "ops", "vercel.md"),
+    await fs28.outputFile(
+      path29.join(projectDir, "docs", "style-guide", "ops", "vercel.md"),
       `# Vercel
 
 - \`vercel.json\` \u2014 Next.js framework hint
@@ -3714,33 +3777,29 @@ async function runInstallers(ctx, onProgress) {
 
 // src/scaffold.ts
 async function scaffold(options) {
-  const projectDir = path29.resolve(process.cwd(), options.name);
+  const projectDir = options.outDir ?? resolveProjectTarget(options.name).outDir;
   const pm = getPackageManager(options.packageManager);
-  if (await fs28.pathExists(projectDir)) {
-    const entries = await fs28.readdir(projectDir);
-    if (entries.length > 0) {
-      throw new Error(
-        `Target directory already exists and is not empty: ${projectDir}`
-      );
-    }
-  }
+  await assertDirScaffoldable(projectDir);
   const spin = p2.spinner();
-  spin.start("Copying template");
+  spin.start(
+    projectDir === path30.resolve(process.cwd()) ? "Copying template into current directory" : "Copying template"
+  );
   await yieldUi();
-  if (!await fs28.pathExists(TEMPLATE_DIR)) {
+  if (!await fs29.pathExists(TEMPLATE_DIR)) {
     spin.stop("Template missing");
     throw new Error(`Template directory not found at ${TEMPLATE_DIR}`);
   }
-  await fs28.copy(TEMPLATE_DIR, projectDir, {
+  await fs29.ensureDir(projectDir);
+  await fs29.copy(TEMPLATE_DIR, projectDir, {
     filter: (src) => {
-      const base = path29.basename(src);
+      const base = path30.basename(src);
       return base !== "node_modules" && base !== ".next" && base !== "dist";
     }
   });
-  const gitignoreSrc = path29.join(projectDir, "gitignore");
-  const gitignoreDest = path29.join(projectDir, ".gitignore");
-  if (await fs28.pathExists(gitignoreSrc)) {
-    await fs28.move(gitignoreSrc, gitignoreDest, { overwrite: true });
+  const gitignoreSrc = path30.join(projectDir, "gitignore");
+  const gitignoreDest = path30.join(projectDir, ".gitignore");
+  if (await fs29.pathExists(gitignoreSrc)) {
+    await fs29.move(gitignoreSrc, gitignoreDest, { overwrite: true });
   }
   spin.message("Applying project tokens");
   await yieldUi();
@@ -3797,8 +3856,8 @@ async function scaffold(options) {
 }
 
 // src/upgrade.ts
-import fs29 from "fs-extra";
-import path30 from "path";
+import fs30 from "fs-extra";
+import path31 from "path";
 import * as p3 from "@clack/prompts";
 import color3 from "picocolors";
 var TRACKED = [
@@ -3808,17 +3867,17 @@ var TRACKED = [
   ".cursor/rules/forms.mdc"
 ];
 function rel(projectDir, file) {
-  return path30.join(projectDir, file);
+  return path31.join(projectDir, file);
 }
 function templatePath(file) {
-  return path30.join(TEMPLATE_DIR, file);
+  return path31.join(TEMPLATE_DIR, file);
 }
 async function runUpgrade(options) {
   const { projectDir, apply } = options;
-  if (!await fs29.pathExists(path30.join(projectDir, "package.json"))) {
+  if (!await fs30.pathExists(path31.join(projectDir, "package.json"))) {
     throw new Error(`Not an app directory (missing package.json): ${projectDir}`);
   }
-  if (!await fs29.pathExists(TEMPLATE_DIR)) {
+  if (!await fs30.pathExists(TEMPLATE_DIR)) {
     throw new Error(`Template missing at ${TEMPLATE_DIR}`);
   }
   p3.intro(color3.bgCyan(color3.black(" next-style-guide upgrade ")));
@@ -3831,14 +3890,14 @@ async function runUpgrade(options) {
   for (const file of TRACKED) {
     const from = templatePath(file);
     const to = rel(projectDir, file);
-    if (!await fs29.pathExists(from)) {
+    if (!await fs30.pathExists(from)) {
       p3.log.warn(`Template missing ${file}`);
       continue;
     }
-    const next = await fs29.readFile(from, "utf8");
+    const next = await fs30.readFile(from, "utf8");
     let outgoing = next;
-    if (file === "AGENTS.md" && await fs29.pathExists(to)) {
-      const current2 = await fs29.readFile(to, "utf8");
+    if (file === "AGENTS.md" && await fs30.pathExists(to)) {
+      const current2 = await fs30.readFile(to, "utf8");
       const nameMatch = current2.match(/^# Agents \((.+)\)$/m);
       if (nameMatch?.[1]) {
         outgoing = outgoing.replace("__PROJECT_NAME__", nameMatch[1]);
@@ -3851,18 +3910,18 @@ async function runUpgrade(options) {
         }
       }
     }
-    outgoing = outgoing.replaceAll("__PROJECT_NAME__", path30.basename(projectDir)).replaceAll("__PACKAGE_MANAGER__", "pnpm").replaceAll("__PROJECT_SLUG__", path30.basename(projectDir));
-    if (!await fs29.pathExists(to)) {
+    outgoing = outgoing.replaceAll("__PROJECT_NAME__", path31.basename(projectDir)).replaceAll("__PACKAGE_MANAGER__", "pnpm").replaceAll("__PROJECT_SLUG__", path31.basename(projectDir));
+    if (!await fs30.pathExists(to)) {
       missing += 1;
       p3.log.warn(`missing  ${file}`);
       if (apply) {
-        await fs29.ensureDir(path30.dirname(to));
-        await fs29.writeFile(to, outgoing, "utf8");
+        await fs30.ensureDir(path31.dirname(to));
+        await fs30.writeFile(to, outgoing, "utf8");
         p3.log.success(`wrote    ${file}`);
       }
       continue;
     }
-    const current = await fs29.readFile(to, "utf8");
+    const current = await fs30.readFile(to, "utf8");
     if (current === outgoing) {
       same += 1;
       p3.log.step(color3.dim(`same     ${file}`));
@@ -3871,7 +3930,7 @@ async function runUpgrade(options) {
     changed += 1;
     p3.log.warn(`differs  ${file}`);
     if (apply) {
-      await fs29.writeFile(to, outgoing, "utf8");
+      await fs30.writeFile(to, outgoing, "utf8");
       p3.log.success(`updated  ${file}`);
     }
   }
@@ -4078,6 +4137,7 @@ ${TITLE} \u2014 ${PKG_NAME}
 
 Usage:
   npx create-next-style-guide [name] [options]
+  npx create-next-style-guide . [options]          # scaffold into current directory
   npx create-next-style-guide upgrade [--apply] [dir]
   npx create-next-style-guide --diff [dir]
 
@@ -4150,18 +4210,19 @@ function applyFlagOverrides(options, flags) {
 async function main() {
   const flags = parseArgs(process.argv);
   if (flags.upgrade) {
-    const projectDir2 = path31.resolve(process.cwd(), flags.name ?? ".");
+    const projectDir2 = path32.resolve(process.cwd(), flags.name ?? ".");
     await runUpgrade({ projectDir: projectDir2, apply: flags.apply });
     return;
   }
   let options;
   if (flags.yes) {
-    const name = (flags.name ?? "my-app").trim();
+    const target = resolveProjectTarget(flags.name ?? "my-app");
     const presetSeed = flags.preset && flags.preset !== "custom" ? PRESET_SEEDS[flags.preset] : DEFAULT_OPTIONS;
     options = applyFlagOverrides(
       {
-        name,
-        slug: slugify(name),
+        name: target.name,
+        slug: target.slug,
+        outDir: target.outDir,
         ...presetSeed,
         noInstall: flags.noInstall
       },
@@ -4171,6 +4232,7 @@ async function main() {
     p4.log.info(
       [
         `Non-interactive: ${options.name} (${options.slug})`,
+        target.inPlace ? `out=. (${target.outDir})` : null,
         flags.preset ? `preset=${flags.preset}` : null,
         `pm=${options.packageManager}`,
         `styling=${options.styling} ui=${options.ui}${options.ui === "shadcn" ? `:${options.shadcnSet}` : ""} auth=${options.auth} store=${options.store}`,
@@ -4189,7 +4251,7 @@ async function main() {
   const projectDir = await scaffold(options);
   const pm = getPackageManager(options.packageManager);
   const nextSteps = [
-    `cd ${path31.relative(process.cwd(), projectDir) || "."}`,
+    `cd ${path32.relative(process.cwd(), projectDir) || "."}`,
     options.noInstall ? `${pm.id} ${pm.installArgs.filter((a) => a !== "--ignore-workspace").join(" ")}`.trim() : null,
     options.ui === "shadcn" && options.shadcnSet === "minimal" ? "npx shadcn@latest add input   # or re-scaffold with --shadcn-set starter" : null,
     options.endpoints ? `${pm.runScript("endpoints:generate")}   # when API schema is up` : null,