create-prodkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lalit Kakkar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# create-prodkit
+
+A CLI to scaffold a production-ready Next.js project with only the tools you actually want — no bloat, no manual setup every time.
+
+## Usage
+
+```bash
+npx create-prodkit my-app
+```
+
+Or scaffold into the current folder:
+
+```bash
+npx create-prodkit .
+```
+
+## What it sets up
+
+When you run the CLI it asks a few questions then sets everything up in one shot:
+
+**Package manager** — choose between npm, yarn, or pnpm
+
+**Features** — pick what you need:
+
+| Feature           | What it does                                            |
+| ----------------- | ------------------------------------------------------- |
+| Tailwind CSS      | Installed via `create-next-app` + `cn()` utility helper |
+| ESLint + Prettier | Prettier config with import sorting                     |
+| Husky             | Git hooks with lint-staged pre-commit                   |
+| release-it        | Changelog generation + semantic versioning              |
+| Absolute imports  | `@/*`, `@components/*`, `@lib/*`, `@hooks/*`            |
+
+## Project structure
+
+Projects are scaffolded with the `app/` directory at the root (no `src/` wrapper):
+
+```
+my-app/
+├── app/
+│   ├── globals.css
+│   ├── layout.tsx
+│   └── page.tsx
+├── components/     ← added if absolute-imports selected
+├── lib/
+│   └── utils.ts   ← cn() helper (added if Tailwind selected)
+├── hooks/
+├── public/
+├── next.config.ts
+└── package.json
+```
+
+## Feature details
+
+### Tailwind CSS
+
+Installed via the `create-next-app` `--tailwind` flag. When selected, two utilities are also added:
+
+- `clsx` — conditional class helper
+- `tailwind-merge` — merges Tailwind classes without conflicts
+
+A `lib/utils.ts` file is created with a ready-to-use `cn()` helper:
+
+```ts
+import { cn } from '@/lib/utils'
+
+// Conditional classes, deduplication, conflict resolution — all handled
+<div className={cn('px-4 py-2', isActive && 'bg-blue-500', 'text-sm')} />
+```
+
+### ESLint + Prettier
+
+Adds `.prettierrc` with sane defaults — single quotes, no semicolons, 100 char print width. Also adds `@trivago/prettier-plugin-sort-imports` which auto-sorts your imports on save:
+
+```ts
+import { useState } from "react";
+
+import Link from "next/link";
+
+import axios from "axios";
+
+import { Button } from "@/components/ui/button";
+```
+
+### Husky
+
+Sets up `.husky/` with your choice of hooks:
+
+- `pre-commit` — runs lint-staged on changed files only before every commit
+- `commit-msg` — runs commitlint to enforce conventional commit format (installs `@commitlint/cli` + `@commitlint/config-conventional` automatically)
+
+### release-it
+
+Replaces the deprecated `standard-version`. Adds `npm run release` scripts and a `.release-it.json` config with conventional changelog:
+
+```bash
+npm run release          # auto bump + generate CHANGELOG.md
+npm run release:patch    # force patch bump
+npm run release:minor    # force minor bump
+npm run release:major    # force major bump
+```
+
+### Absolute imports
+
+Extends `tsconfig.json` with path aliases so you never write `../../../` again:
+
+```ts
+import { Button } from "@/components/ui/button";
+import { useAuth } from "@hooks/useAuth";
+import { formatDate } from "@lib/utils";
+```
+
+## Requirements
+
+- Node.js 18+
+- Git installed (required if Husky selected)
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+import { run } from "../src/cli.js";
+
+// fix emoji rendering in Git Bash / Windows terminals
+if (process.platform === "win32") {
+  process.stdout.write("\u001b]0;\u001b\\"); // reset terminal title
+}
+
+run();

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "create-prodkit",
+  "version": "1.0.0",
+  "description": "CLI for scaffolding production-ready Next.js applications with TypeScript, Tailwind CSS, ESLint, Prettier and modern project tooling.",
+  "main": "src/cli.js",
+  "bin": {
+    "create-prodkit": "bin/index.js"
+  },
+  "type": "module",
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "dev": "node bin/index.js",
+    "prepare": "husky",
+    "release": "release-it",
+    "release:patch": "release-it patch",
+    "release:minor": "release-it minor",
+    "release:major": "release-it major"
+  },
+  "lint-staged": {
+    "**/*.js": [
+      "prettier --write"
+    ]
+  },
+  "devDependencies": {
+    "@release-it/conventional-changelog": "^11.0.1",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.2.0",
+    "release-it": "^20.2.0"
+  },
+  "keywords": [
+    "nextjs",
+    "cli",
+    "scaffold",
+    "starter-template",
+    "tailwindcss",
+    "typescript",
+    "eslint",
+    "prettier",
+    "nextjs-boilerplate",
+    "developer-tools"
+  ],
+  "license": "MIT",
+  "author": "Lalit Kakkar <lalitkakkar50@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kakkar2/create-prodkit.git"
+  },
+  "homepage": "https://github.com/kakkar2/create-prodkit#readme",
+  "bugs": {
+    "url": "https://github.com/kakkar2/create-prodkit/issues"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.3.5",
+    "inquirer": "^9.3.8",
+    "ora": "^8.2.0",
+    "picocolors": "^1.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,35 @@
+import { Command } from "commander";
+import { createRequire } from "module";
+import { getProjectOptions } from "./prompts.js";
+import { createProject } from "./scaffold.js";
+import pc from "picocolors";
+
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+
+const program = new Command();
+
+export async function run() {
+  program
+    .name("create-prodkit")
+    .description("Scaffold a production-ready project")
+    .version(version)
+    .argument("[project-name]", "Name of the project folder to create")
+    .action(async (projectName) => {
+      console.log();
+      console.log(pc.bold(pc.cyan("  >> create-prodkit")));
+      console.log(pc.dim("  A production-ready project scaffold\n"));
+
+      const options = await getProjectOptions(projectName); // ← add this
+
+      if (!options.confirmed) {
+        // ← add this
+        console.log(pc.dim("\n  Cancelled.\n"));
+        process.exit(0);
+      }
+
+      await createProject(options); // ← pass full options now
+    });
+
+  program.parse();
+}

package/src/features/absoluteImports.js

@@ -0,0 +1,23 @@
+import path from "path";
+import fs from "fs-extra";
+import { runStep } from "../utils/runStep.js";
+
+export async function setupAbsoluteImports(targetDir) {
+  await runStep("Configuring absolute imports...", async () => {
+    const tsconfigPath = path.join(targetDir, "tsconfig.json");
+    const tsconfig = await fs.readJson(tsconfigPath);
+
+    tsconfig.compilerOptions = tsconfig.compilerOptions || {};
+    tsconfig.compilerOptions.baseUrl = ".";
+    // Merge with any existing paths (create-next-app sets @/* already)
+    tsconfig.compilerOptions.paths = {
+      ...(tsconfig.compilerOptions.paths || {}),
+      "@/*": ["./*"],              // root alias
+      "@components/*": ["./components/*"],
+      "@lib/*": ["./lib/*"],
+      "@hooks/*": ["./hooks/*"],
+    };
+
+    await fs.writeJson(tsconfigPath, tsconfig, { spaces: 2 });
+  });
+}

package/src/features/husky.js

@@ -0,0 +1,26 @@
+import path from "path";
+import fs from "fs-extra";
+import { execa } from "execa";
+import { runStep } from "../utils/runStep.js";
+
+export async function setupHusky({ targetDir, huskyHooks }) {
+  await runStep("Setting up Husky hooks...", async () => {
+    await execa("npx", ["husky", "init"], { cwd: targetDir, stdio: "pipe" });
+
+    if (huskyHooks.includes("pre-commit")) {
+      const hookPath = path.join(targetDir, ".husky", "pre-commit");
+      await fs.outputFile(hookPath, "npx lint-staged\n");
+      // husky v9 sets executable bit automatically during init — no chmod needed
+    }
+
+    if (huskyHooks.includes("commit-msg")) {
+      const hookPath = path.join(targetDir, ".husky", "commit-msg");
+      await fs.outputFile(hookPath, "npx --no -- commitlint --edit $1\n");
+      // commitlint config — uses conventional commit rules
+      await fs.outputFile(
+        path.join(targetDir, "commitlint.config.js"),
+        `export default { extends: ['@commitlint/config-conventional'] }\n`,
+      );
+    }
+  });
+}

package/src/features/index.js

@@ -0,0 +1,13 @@
+import { setupHusky } from "./husky.js";
+import { setupReleaseIt } from "./releaseIt.js";
+import { setupPrettier } from "./prettier.js";
+import { setupAbsoluteImports } from "./absoluteImports.js";
+import { setupTailwindUtils } from "./tailwindUtils.js";
+
+export {
+  setupHusky,
+  setupReleaseIt,
+  setupPrettier,
+  setupAbsoluteImports,
+  setupTailwindUtils,
+};

package/src/features/prettier.js

@@ -0,0 +1,36 @@
+import path from "path";
+import fs from "fs-extra";
+import { runStep } from "../utils/runStep.js";
+
+export async function setupPrettier(targetDir) {
+  await runStep("Adding Prettier config...", async () => {
+    await fs.writeJson(
+      path.join(targetDir, ".prettierrc"),
+      {
+        semi: false,
+        singleQuote: true,
+        tabWidth: 2,
+        trailingComma: "es5",
+        printWidth: 100,
+        plugins: ["@trivago/prettier-plugin-sort-imports"],
+        importOrder: [
+          "^react(.*)$",
+          "^next(.*)$",
+          "<THIRD_PARTY_MODULES>",
+          "^@/(.*)$",
+          "^[./]",
+        ],
+        importOrderSeparation: true,
+        importOrderSortSpecifiers: true,
+      },
+      { spaces: 2 },
+    );
+
+    const eslintPath = path.join(targetDir, ".eslintrc.json");
+    if (await fs.pathExists(eslintPath)) {
+      const eslint = await fs.readJson(eslintPath);
+      eslint.extends = [...(eslint.extends || []), "prettier"];
+      await fs.writeJson(eslintPath, eslint, { spaces: 2 });
+    }
+  });
+}

package/src/features/releaseIt.js

@@ -0,0 +1,34 @@
+import path from "path";
+import fs from "fs-extra";
+import { runStep } from "../utils/runStep.js";
+
+export async function setupReleaseIt(targetDir) {
+  await runStep("Configuring release-it...", async () => {
+    const config = {
+      git: {
+        commitMessage: "chore: release v${version}",
+        tagName: "v${version}",
+        requireCleanWorkingDir: false,
+      },
+      npm: {
+        publish: false,
+      },
+      github: {
+        release: false,
+      },
+      plugins: {
+        "@release-it/conventional-changelog": {
+          preset: {
+            name: "angular",
+          },
+          infile: "CHANGELOG.md",
+          header: "# Changelog\n\nAll notable changes are documented here.\n",
+        },
+      },
+    };
+
+    await fs.writeJson(path.join(targetDir, ".release-it.json"), config, {
+      spaces: 2,
+    });
+  });
+}

package/src/features/tailwindUtils.js

@@ -0,0 +1,30 @@
+import path from "path";
+import fs from "fs-extra";
+import { runStep } from "../utils/runStep.js";
+
+export async function setupTailwindUtils(targetDir) {
+  await runStep("Adding clsx + tailwind-merge utils...", async () => {
+    // Create lib/ directory at project root (no src/ dir)
+    const libDir = path.join(targetDir, "lib");
+    await fs.ensureDir(libDir);
+
+    // cn() helper — merges Tailwind classes safely, deduplicates conflicts
+    const utilsContent = `import { type ClassValue, clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+/**
+ * Merge Tailwind CSS classes safely.
+ * Resolves class conflicts (e.g. p-4 + p-2 → p-2) and
+ * supports conditional classes via clsx syntax.
+ *
+ * @example
+ * cn('px-4 py-2', isActive && 'bg-blue-500', 'text-sm')
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+`;
+
+    await fs.writeFile(path.join(libDir, "utils.ts"), utilsContent, "utf-8");
+  });
+}

package/src/installer.js

@@ -0,0 +1,66 @@
+import { execa } from "execa";
+import path from "path";
+import fs from "fs-extra";
+import { logger } from "./utils/logger.js";
+import {
+  setupAbsoluteImports,
+  setupPrettier,
+  setupReleaseIt,
+  setupHusky,
+  setupTailwindUtils,
+} from "./features/index.js";
+import { runStep } from "./utils/runStep.js";
+import { modifyPackageJson } from "./utils/modifyPackageJson.js";
+
+export async function installFeatures(options) {
+  const { targetDir, packageManager, features, huskyHooks } = options;
+
+  // ── 1. Modify package.json before install ─────────────────────
+  // Pass huskyHooks so commitlint deps are added when commit-msg is selected
+  await modifyPackageJson(targetDir, features, packageManager, huskyHooks);
+
+  // ── 2. git init (must happen before husky setup) ──────────────
+  if (features.includes("husky")) {
+    await runStep("Initializing git repo...", async () => {
+      await execa("git", ["init"], { cwd: targetDir });
+    });
+  }
+
+  // ── 3. Single install pass (picks up all deps we just added) ──
+  await runStep(
+    `Installing dependencies with ${packageManager}...`,
+    async () => {
+      await execa(packageManager, ["install"], {
+        cwd: targetDir,
+        stdio: "pipe",
+      });
+    },
+  );
+
+  // ── 4. Husky setup ────────────────────────────────────────────
+  if (features.includes("husky")) {
+    await setupHusky({ targetDir, huskyHooks, packageManager });
+  }
+
+  // ── 5. release-it config ──────────────────────────────────────
+  if (features.includes("release-it")) {
+    await setupReleaseIt(targetDir);
+  }
+
+  // ── 6. Prettier config ────────────────────────────────────────
+  if (features.includes("eslint")) {
+    await setupPrettier(targetDir);
+  }
+
+  // ── 7. Tailwind utils (clsx + tailwind-merge cn helper) ───────
+  if (features.includes("tailwind")) {
+    await setupTailwindUtils(targetDir);
+  }
+
+  // ── 8. Absolute imports ───────────────────────────────────────
+  if (features.includes("absolute-imports")) {
+    await setupAbsoluteImports(targetDir);
+  }
+
+  logger.success("All features installed\n");
+}

package/src/prompts.js

@@ -0,0 +1,106 @@
+import inquirer from "inquirer";
+import path from "path";
+import fs from "fs";
+
+export async function getProjectOptions(projectNameArg) {
+  const answers = await inquirer.prompt([
+    // ── 1. Project name ──────────────────────────────────────────
+    {
+      type: "input",
+      name: "projectName",
+      message: "Project name:",
+      default: projectNameArg || "my-next-app",
+      when: !projectNameArg,
+      validate: (input) => {
+        if (!input.trim()) return "Project name cannot be empty";
+        if (!/^[a-z0-9-_]+$/.test(input))
+          return "Only lowercase letters, numbers, - and _ allowed";
+        return true;
+      },
+    },
+
+    // ── 2. Package manager ───────────────────────────────────────
+    {
+      type: "list",
+      name: "packageManager",
+      message: "Package manager:",
+      choices: ["npm", "yarn", "pnpm"],
+      default: "npm",
+    },
+
+    // ── 3. Feature selection ─────────────────────────────────────
+    {
+      type: "checkbox",
+      name: "features",
+      message: "Select features to include:",
+      choices: [
+        {
+          name: "Tailwind CSS  (+ clsx & tailwind-merge cn helper)",
+          value: "tailwind",
+          checked: true,
+        },
+        {
+          name: "ESLint + Prettier",
+          value: "eslint",
+          checked: true,
+        },
+        {
+          name: "Husky  (git hooks + pre-commit lint-staged)",
+          value: "husky",
+          checked: false,
+        },
+        {
+          name: "release-it  (changelog + semantic versioning)",
+          value: "release-it",
+          checked: false,
+        },
+        {
+          name: "Absolute imports  (@/* → root, @components/*, @lib/*, @hooks/*)",
+          value: "absolute-imports",
+          checked: true,
+        },
+      ],
+    },
+
+    // ── 4. Husky hook selection ───────────────────────────────────
+    {
+      type: "checkbox",
+      name: "huskyHooks",
+      message: "Which git hooks do you want?",
+      choices: [
+        {
+          name: "pre-commit  → lint-staged (lint + format changed files)",
+          value: "pre-commit",
+          checked: true,
+        },
+        {
+          name: "commit-msg  → commitlint (enforce conventional commits)",
+          value: "commit-msg",
+          checked: false,
+        },
+      ],
+      when: (ans) => ans.features.includes("husky"),
+    },
+
+    // ── 5. Confirm before doing anything ─────────────────────────
+    {
+      type: "confirm",
+      name: "confirm",
+      message: (ans) => {
+        const name = projectNameArg || ans.projectName;
+        return `Create project "${name}" with selected options?`;
+      },
+      default: true,
+    },
+  ]);
+
+  const projectName = projectNameArg || answers.projectName;
+
+  return {
+    projectName,
+    packageManager: answers.packageManager,
+    features: answers.features,
+    huskyHooks: answers.huskyHooks || [],
+    confirmed: answers.confirm,
+  };
+}

package/src/scaffold.js

@@ -0,0 +1,105 @@
+import path from "path";
+import fs from "fs";
+import { execa } from "execa";
+import ora from "ora";
+import pc from "picocolors";
+import { logger } from "./utils/logger.js";
+import { installFeatures } from "./installer.js";
+
+export async function createProject(options) {
+  const { projectName, packageManager, features } = options;
+
+  // ── 1. Resolve target directory ───────────────────────────────
+  const isSameDir = projectName === ".";
+  const targetDir = isSameDir
+    ? process.cwd()
+    : path.resolve(process.cwd(), projectName);
+
+  const appName = isSameDir ? path.basename(process.cwd()) : projectName;
+
+  // ── 2. Check if folder exists and has files ───────────────────
+  if (!isSameDir && fs.existsSync(targetDir)) {
+    const files = fs.readdirSync(targetDir);
+    if (files.length > 0) {
+      logger.error(`Folder "${projectName}" already exists and is not empty.`);
+      logger.dim("Delete it or choose a different name.");
+      process.exit(1);
+    }
+  }
+
+  // ── 3. Build create-next-app args ─────────────────────────────
+  const nextArgs = [
+    "create-next-app@latest",
+    isSameDir ? "." : projectName,
+    "--typescript",
+    "--app",        // use App Router
+    "--no-src-dir", // scaffold app/ at root (not inside src/)
+    "--no-git",     // we'll init git ourselves if husky selected
+    "--no-install", // we'll run install ourselves
+    "--import-alias",
+    "@/*",          // default alias → maps to ./* at root
+    `--use-${packageManager}`,
+  ];
+
+  // if tailwind selected, pass the flag — otherwise skip it
+  if (features.includes("tailwind")) {
+    nextArgs.push("--tailwind");
+  } else {
+    nextArgs.push("--no-tailwind");
+  }
+
+  // ESLint flag
+  if (features.includes("eslint")) {
+    nextArgs.push("--eslint");
+  } else {
+    nextArgs.push("--no-eslint");
+  }
+
+  // ── 4. Run create-next-app ────────────────────────────────────
+  logger.step("Creating Next.js project...");
+
+  const spinner = ora({
+    text: "Running create-next-app...",
+    color: "cyan",
+  }).start();
+
+  try {
+    await execa("npx", nextArgs, {
+      cwd: isSameDir ? targetDir : process.cwd(),
+      stdio: "pipe", // suppress create-next-app's own output
+    });
+    spinner.succeed(pc.green("Next.js project created"));
+  } catch (err) {
+    spinner.fail("create-next-app failed");
+    logger.error(err.message);
+    process.exit(1);
+  }
+
+  // ── 5. Install selected features ──────────────────────────────
+  await installFeatures({
+    ...options,
+    targetDir,
+    appName,
+  });
+
+  // ── 6. Done ───────────────────────────────────────────────────
+  printSuccess({ appName, isSameDir, projectName, packageManager });
+}
+
+// ── Success message ────────────────────────────────────────────
+function printSuccess({ appName, isSameDir, projectName, packageManager }) {
+  const runCmd =
+    packageManager === "npm" ? "npm run dev" : `${packageManager} dev`;
+
+  console.log();
+  console.log(pc.bold(pc.green("  ✔ Project ready!")));
+  console.log();
+
+  if (!isSameDir) {
+    console.log(pc.dim("  Next steps:"));
+    console.log(pc.cyan(`    cd ${projectName}`));
+  }
+
+  console.log(pc.cyan(`    ${runCmd}`));
+  console.log();
+}

package/src/utils/logger.js

@@ -0,0 +1,20 @@
+import pc from "picocolors";
+
+// these render correctly in Git Bash, PowerShell, Mac, Linux
+const S = {
+  info: pc.cyan("i"),
+  success: pc.green("√"),
+  warn: pc.yellow("‼"),
+  error: pc.red("×"),
+  rocket: pc.cyan(">>"),
+  bullet: pc.dim("·"),
+};
+
+export const logger = {
+  info: (msg) => console.log(S.info + "  " + msg),
+  success: (msg) => console.log(S.success + "  " + msg),
+  warn: (msg) => console.log(S.warn + "  " + msg),
+  error: (msg) => console.log(S.error + "  " + msg),
+  step: (msg) => console.log(pc.bold(pc.white("\n  " + msg))),
+  dim: (msg) => console.log(pc.dim("  " + msg)),
+};

package/src/utils/modifyPackageJson.js

@@ -0,0 +1,58 @@
+import path from "path";
+import fs from "fs-extra";
+import { logger } from "./logger.js";
+
+export async function modifyPackageJson(targetDir, features, packageManager, huskyHooks = []) {
+  const pkgPath = path.join(targetDir, "package.json");
+  const pkg = await fs.readJson(pkgPath);
+
+  pkg.devDependencies = pkg.devDependencies || {};
+  pkg.dependencies = pkg.dependencies || {};
+  pkg.scripts = pkg.scripts || {};
+
+  // ── Tailwind utils ─────────────────────────────────────────────
+  if (features.includes("tailwind")) {
+    // Runtime deps — used directly in component code
+    pkg.dependencies["clsx"] = "^2.1.0";
+    pkg.dependencies["tailwind-merge"] = "^2.3.0";
+  }
+
+  // ── ESLint + Prettier ──────────────────────────────────────────
+  if (features.includes("eslint")) {
+    pkg.devDependencies["prettier"] = "^3.2.0";
+    pkg.devDependencies["eslint-config-prettier"] = "^9.1.0";
+    pkg.devDependencies["@trivago/prettier-plugin-sort-imports"] = "^4.3.0";
+  }
+
+  // ── Husky ──────────────────────────────────────────────────────
+  if (features.includes("husky")) {
+    pkg.devDependencies["husky"] = "^9.0.0";
+    pkg.devDependencies["lint-staged"] = "^15.2.0";
+    pkg["lint-staged"] = {
+      "**/*.{js,jsx,ts,tsx}": ["eslint --fix", "prettier --write"],
+      "**/*.{json,css,md}": ["prettier --write"],
+    };
+    // prepare runs husky on npm install — safe because husky
+    // skips silently when .git is absent (e.g. in Docker/CI)
+    pkg.scripts["prepare"] = "husky";
+
+    // commitlint packages — only needed when commit-msg hook is selected
+    if (huskyHooks.includes("commit-msg")) {
+      pkg.devDependencies["@commitlint/cli"] = "^19.0.0";
+      pkg.devDependencies["@commitlint/config-conventional"] = "^19.0.0";
+    }
+  }
+
+  // ── release-it ────────────────────────────────────────────────
+  if (features.includes("release-it")) {
+    pkg.devDependencies["release-it"] = "^17.0.0";
+    pkg.devDependencies["@release-it/conventional-changelog"] = "^8.0.0";
+    pkg.scripts["release"] = "release-it";
+    pkg.scripts["release:patch"] = "release-it patch";
+    pkg.scripts["release:minor"] = "release-it minor";
+    pkg.scripts["release:major"] = "release-it major";
+  }
+
+  await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+  logger.success("package.json updated");
+}

package/src/utils/runStep.js

@@ -0,0 +1,29 @@
+import ora from "ora";
+import pc from "picocolors";
+import { logger } from "./logger.js";
+
+// ASCII spinner frames — work on every terminal including Git Bash
+const spinner_frames =
+  process.platform === "win32"
+    ? ["-", "\\", "|", "/"] // ASCII fallback for Windows
+    : ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]; // nice on Mac/Linux
+
+export async function runStep(message, fn) {
+  const spinner = ora({
+    text: message,
+    color: "cyan",
+    spinner: {
+      interval: 80,
+      frames: spinner_frames,
+    },
+  }).start();
+
+  try {
+    await fn();
+    spinner.succeed(pc.green(message.replace("...", " done")));
+  } catch (err) {
+    spinner.fail(pc.red(message.replace("...", " failed")));
+    logger.error(err.message);
+    process.exit(1);
+  }
+}