create-template-project 1.0.0 → 1.1.2

package/README.md

@@ -27,7 +27,7 @@ pnpm dlx create-template-project interactive
   - **Seed File Protection:** Files in `src/`, all `*.md` files, and other core files are skipped to protect your application logic and custom documentation.
   - **Tooling Sync:** Keeps your project's boilerplate (linting, CI, configs, scripts) up-to-date with the latest template versions.
 - **No-Build Option:** Supports creating simple projects without a build step (strips Vite).
-- **GitHub Integration:** Automatically initializes a Git repository and can create a GitHub repository using the `gh` CLI.
+- **GitHub Integration:** Automatically initializes a Git repository and can create a GitHub repository (including initial commit and push) using the `gh` CLI.
 - **CI Ready:** Generates GitHub Actions workflows for automated testing and linting.
 
 ## Installation
@@ -89,9 +89,8 @@ create-template-project update --template cli
 - `-a, --author <author>`: Author name (defaults to 'git config user.name')
 - `--github-username <username>`: GitHub username (defaults to 'git config github.user')
 - `-p, --package-manager <pm>`: Package manager (`npm`, `pnpm`, `yarn`) (defaults to `pnpm`)
-- `--create-github-repository`: Create GitHub project (requires `gh` CLI authenticated)
+- `--create-github-repository`: Create GitHub repository and push initial commit (requires `gh` CLI authenticated)
 - `--path <path>`: Output directory (mandatory)
-- `--install-dependencies`: Install dependencies after scaffolding
 - `--build`: Run the CI script (lint, build, test) after scaffolding
 - `--no-progress`: Do not show progress indicators
 
@@ -103,9 +102,8 @@ create-template-project update --template cli
 - `-a, --author <author>`: Author name (defaults to 'git config user.name')
 - `--github-username <username>`: GitHub username (defaults to 'git config github.user')
 - `-p, --package-manager <pm>`: Package manager (`npm`, `pnpm`, `yarn`) (defaults to `pnpm`)
-- `--create-github-repository`: Create GitHub project (requires `gh` CLI authenticated)
+- `--create-github-repository`: Create GitHub repository and push initial commit (requires `gh` CLI authenticated)
 - `-d, --directory <path>`: Output directory (defaults to `.`)
-- `--install-dependencies`: Install dependencies after updating
 - `--build`: Run the CI script (lint, build, test) after updating
 - `--dev`: Run the dev server after updating
 - `--open`: Open the browser after updating

package/dist/config/dependencies.json

@@ -1,7 +1,7 @@
 {
 	"dependencies": {
 		"vite": {
-			"version": "8.0.2",
+			"version": "8.0.3",
 			"description": "Native-ESM powered web dev build tool"
 		},
 		"@vitejs/plugin-react": {
@@ -9,15 +9,15 @@
 			"description": "The default Vite plugin for React projects."
 		},
 		"@vitest/browser": {
-			"version": "4.1.1",
+			"version": "4.1.2",
 			"description": "Run Vitest in the browser."
 		},
 		"@vitest/browser-playwright": {
-			"version": "4.1.1",
+			"version": "4.1.2",
 			"description": "Playwright provider for Vitest browser mode."
 		},
 		"playwright": {
-			"version": "1.58.2",
+			"version": "1.59.1",
 			"description": "Framework for Web-browser automation."
 		},
 		"debug": {
@@ -37,11 +37,11 @@
 			"description": "TypeScript definitions for debug."
 		},
 		"@types/node": {
-			"version": "25.5.0",
+			"version": "25.5.2",
 			"description": "TypeScript definitions for Node.js."
 		},
 		"@vitest/coverage-v8": {
-			"version": "4.1.1",
+			"version": "4.1.2",
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
@@ -53,23 +53,23 @@
 			"description": "Modern native git hooks made easy."
 		},
 		"oxlint": {
-			"version": "1.56.0",
+			"version": "1.58.0",
 			"description": "A JavaScript linter written in Rust."
 		},
 		"oxlint-tsgolint": {
-			"version": "0.17.1",
+			"version": "0.19.0",
 			"description": "TypeScript-specific rules for oxlint."
 		},
 		"oxfmt": {
-			"version": "0.41.0",
+			"version": "0.43.0",
 			"description": "High performance JavaScript / TypeScript formatter."
 		},
 		"typescript": {
-			"version": "5.9.3",
+			"version": "6.0.2",
 			"description": "A superset of JavaScript that compiles to clean JavaScript output."
 		},
 		"vitest": {
-			"version": "4.1.1",
+			"version": "4.1.2",
 			"description": "A Vite-native unit test framework."
 		},
 		"commander": {
@@ -125,23 +125,23 @@
 			"description": "TypeScript definitions for React DOM."
 		},
 		"@playwright/test": {
-			"version": "1.58.2",
+			"version": "1.59.1",
 			"description": "End-to-end testing framework."
 		},
 		"@trpc/server": {
-			"version": "11.15.0",
+			"version": "11.16.0",
 			"description": "tRPC server library."
 		},
 		"@trpc/client": {
-			"version": "11.15.0",
+			"version": "11.16.0",
 			"description": "tRPC client library."
 		},
 		"@trpc/react-query": {
-			"version": "11.15.0",
+			"version": "11.16.0",
 			"description": "tRPC integration for React Query."
 		},
 		"@tanstack/react-query": {
-			"version": "5.95.2",
+			"version": "5.96.2",
 			"description": "Powerful asynchronous state management for TS/JS."
 		},
 		"zod": {
@@ -149,9 +149,13 @@
 			"description": "TypeScript-first schema validation with static type inference."
 		},
 		"react-router-dom": {
-			"version": "7.13.2",
+			"version": "7.14.0",
 			"description": "Declarative routing for React web applications."
 		},
+		"release-it": {
+			"version": "19.2.4",
+			"description": "Interactive release-tool for Git repositories."
+		},
 		"cors": {
 			"version": "2.8.6",
 			"description": "Node.js CORS middleware."
@@ -165,7 +169,7 @@
 			"description": "ESLint plugin for finding regexp mistakes and style guide violations."
 		},
 		"vitest-browser-react": {
-			"version": "2.1.0",
+			"version": "2.2.0",
 			"description": "Native React testing utilities for Vitest browser mode."
 		}
 	}

package/dist/index.js

@@ -32,7 +32,6 @@ var ProjectOptionsSchema = z.object({
 	createGithubRepository: z.boolean().optional().default(false),
 	directory: z.string(),
 	update: z.boolean().optional().default(false),
-	installDependencies: z.boolean().optional().default(false),
 	build: z.boolean().optional().default(false),
 	progress: z.boolean().optional().default(true)
 });
@@ -258,6 +257,10 @@ var getBaseTemplate = (_opts) => {
 				name: "conventional-changelog",
 				description: "Automated release notes."
 			},
+			{
+				name: "release-it",
+				description: "Automated release workflow."
+			},
 			{
 				name: "debug",
 				description: "Structured logging for debugging."
@@ -268,7 +271,10 @@ var getBaseTemplate = (_opts) => {
 			}
 		],
 		dependencies: { zod: "zod" },
-		devDependencies: { "eslint-plugin-regexp": "" },
+		devDependencies: {
+			"eslint-plugin-regexp": "",
+			"release-it": ""
+		},
 		scripts: {},
 		files: [],
 		templateDir: getTemplateDir(__dirname$5, "base")
@@ -497,7 +503,6 @@ var MOCK_OPTS = {
 	directory: ".",
 	packageManager: "npm",
 	update: false,
-	installDependencies: false,
 	build: false,
 	progress: true,
 	createGithubRepository: false
@@ -540,6 +545,17 @@ var getAllTemplatesInfo = () => {
 //#endregion
 //#region src/cli.ts
 var pathExists$1 = (p) => fs.access(p).then(() => true).catch(() => false);
+var stripQuotes = (str) => {
+	if (typeof str !== "string") return str;
+	let result = str.trim();
+	while (result.length >= 2) {
+		const first = result[0];
+		const last = result[result.length - 1];
+		if (first === "\"" && last === "\"" || first === "'" && last === "'") result = result.substring(1, result.length - 1).trim();
+		else break;
+	}
+	return result;
+};
 var getDefaultAuthor = async () => {
 	try {
 		const { stdout } = await execa("git", ["config", "user.name"]);
@@ -609,7 +625,7 @@ Templates:
 		p.outro("Use \"create\" to scaffold a new project.");
 		process.exit(0);
 	});
-	program.command("create").description("Create a new project from a template").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("-n, --name <name>", "Project name").option("--description <description>", "Project description").option("-k, --keywords <keywords>", "Project keywords (comma separated)").option("-a, --author <author>", "Author name (defaults to 'git config user.name')").option("--github-username <username>", "GitHub username (defaults to 'git config github.user')").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "pnpm").option("--create-github-repository", "Create GitHub project").requiredOption("--path <path>", "Output directory").option("--install-dependencies", "Install dependencies after scaffolding", false).option("--build", "Run the CI script (lint, build, test) after scaffolding", false).option("--no-progress", "Do not show progress indicators").action(async (opts) => {
+	program.command("create").description("Create a new project from a template").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("-n, --name <name>", "Project name").option("--description <description>", "Project description").option("-k, --keywords <keywords>", "Project keywords (comma separated)").option("-a, --author <author>", "Author name (defaults to 'git config user.name')").option("--github-username <username>", "GitHub username (defaults to 'git config github.user')").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "pnpm").option("--create-github-repository", "Create GitHub repository and push initial commit").requiredOption("--path <path>", "Output directory").option("--build", "Run the CI script (lint, build, test) after scaffolding", false).option("--no-progress", "Do not show progress indicators").action(async (opts) => {
 		debug$2("Executing \"create\" command with options: %O", opts);
 		commandResult = {
 			...opts,
@@ -637,7 +653,7 @@ Restrictions & Behavior:
   - package.json: Dependencies and scripts are merged. Existing versions are preserved unless they are missing.
   - Merging: For non-seed files, the tool attempts to merge template changes. If a conflict occurs, it will be marked with standard git conflict markers.
   - Confirmation: The command will always show a summary of proposed changes (ADD, MODIFY) and ask for your confirmation before applying them.
-`).option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("--description <description>", "Project description").option("-k, --keywords <keywords>", "Project keywords (comma separated)").option("-a, --author <author>", "Author name (defaults to 'git config user.name')").option("--github-username <username>", "GitHub username (defaults to 'git config github.user')").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "pnpm").option("--create-github-repository", "Create GitHub project").option("-d, --directory <path>", "Output directory", ".").option("--install-dependencies", "Install dependencies after scaffolding", false).option("--build", "Run the CI script (lint, build, test) after updating", false).option("--dev", "Run the dev server after scaffolding", false).option("--open", "Open the browser after scaffolding", false).option("--no-progress", "Do not show progress indicators").action(async (opts) => {
+`).option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("--description <description>", "Project description").option("-k, --keywords <keywords>", "Project keywords (comma separated)").option("-a, --author <author>", "Author name (defaults to 'git config user.name')").option("--github-username <username>", "GitHub username (defaults to 'git config github.user')").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "pnpm").option("--create-github-repository", "Create GitHub repository and push initial commit").option("-d, --directory <path>", "Output directory", ".").option("--build", "Run the CI script (lint, build, test) after updating", false).option("--dev", "Run the dev server after scaffolding", false).option("--open", "Open the browser after scaffolding", false).option("--no-progress", "Do not show progress indicators").action(async (opts) => {
 		debug$2("Executing \"update\" command with options: %O", opts);
 		const directory = path.resolve(opts.directory);
 		const pkgPath = path.join(directory, "package.json");
@@ -834,29 +850,16 @@ Restrictions & Behavior:
 				process.exit(0);
 			}
 		}
-		const installDependenciesRes = await p.confirm({
-			message: "Should we install dependencies?",
+		const build = await p.confirm({
+			message: "Should we run the CI script (lint, build, test)?",
 			initialValue: true
 		});
-		if (p.isCancel(installDependenciesRes)) {
+		if (p.isCancel(build)) {
 			p.cancel("Operation cancelled.");
 			process.exit(0);
 		}
-		const installDependencies = installDependenciesRes;
-		let build = false;
-		if (installDependencies) {
-			const res = await p.confirm({
-				message: "Should we run the CI script (lint, build, test)?",
-				initialValue: true
-			});
-			if (p.isCancel(res)) {
-				p.cancel("Operation cancelled.");
-				process.exit(0);
-			}
-			build = res;
-		}
 		const createGithubRepositoryRes = await p.confirm({
-			message: "Should we create a GitHub repository?",
+			message: "Create GitHub repository and push initial commit?",
 			initialValue: false
 		});
 		if (p.isCancel(createGithubRepositoryRes)) {
@@ -874,7 +877,6 @@ Restrictions & Behavior:
 			createGithubRepository: createGithubRepositoryRes,
 			directory: projectDir,
 			update,
-			installDependencies,
 			build,
 			progress: true
 		};
@@ -896,6 +898,13 @@ Restrictions & Behavior:
 		p.cancel("Unknown command or missing options.");
 		process.exit(1);
 	}
+	if (commandResult.template) commandResult.template = stripQuotes(commandResult.template);
+	if (commandResult.projectName) commandResult.projectName = stripQuotes(commandResult.projectName);
+	if (commandResult.description) commandResult.description = stripQuotes(commandResult.description);
+	if (commandResult.keywords) commandResult.keywords = stripQuotes(commandResult.keywords);
+	if (commandResult.author) commandResult.author = stripQuotes(commandResult.author);
+	if (commandResult.githubUsername) commandResult.githubUsername = stripQuotes(commandResult.githubUsername);
+	if (commandResult.packageManager) commandResult.packageManager = stripQuotes(commandResult.packageManager);
 	debug$2("Validating command result with Zod");
 	const validationResult = ProjectOptionsSchema.safeParse(commandResult);
 	if (!validationResult.success) {
@@ -909,7 +918,6 @@ Restrictions & Behavior:
 		p.cancel(`Directory "${projectDir}" already exists. Use the "update" command to update.`);
 		process.exit(1);
 	}
-	if (commandResult.build) commandResult.installDependencies = true;
 	return commandResult;
 };
 //#endregion
@@ -993,7 +1001,7 @@ var generateProject = async (opts) => {
 					description: config.description
 				});
 			} else {
-				log.warn(`Dependency "${dep}" not found in master configuration. Using empty version.`);
+				log.warn(`Dependency "${dep}" not found in central configuration. Using empty version.`);
 				debug$1(`Dependency "${dep}" missing in config`);
 			}
 		}
@@ -1001,6 +1009,7 @@ var generateProject = async (opts) => {
 	let finalPkg = {
 		name: projectName,
 		version: "0.1.0",
+		private: true,
 		description: opts.description || "TODO: Add project description",
 		keywords: opts.keywords ? opts.keywords.split(",").map((k) => k.trim()) : ["TODO: Add keywords"],
 		homepage: `https://github.com/${githubUsername}/${projectName}#readme`,
@@ -1273,7 +1282,7 @@ var generateProject = async (opts) => {
 		githubSkipped: !opts.createGithubRepository || isUpdate,
 		githubError: "",
 		depsInstalled: false,
-		depsSkipped: !opts.installDependencies,
+		depsSkipped: !opts.build,
 		ciRun: false,
 		ciSkipped: !opts.build || !finalPkg.scripts.ci
 	};
@@ -1281,13 +1290,13 @@ var generateProject = async (opts) => {
 	if (!await pathExists(path.join(projectDir, ".git"))) {
 		debug$1("Initializing Git repository");
 		try {
-			debug$1("Executing: git init");
-			await execa("git", ["init"], {
+			debug$1("Executing: git init --initial-branch=main");
+			await execa("git", ["init", "--initial-branch=main"], {
 				cwd: projectDir,
 				stdio,
 				preferLocal: true
 			});
-			log.success("Initialized Git repository (git init).");
+			log.success("Initialized Git repository (main branch).");
 			states.gitInitialized = true;
 		} catch (e) {
 			debug$1("Failed to initialize Git: %O", e);
@@ -1295,32 +1304,7 @@ var generateProject = async (opts) => {
 			log.error(`Failed to initialize Git: ${e.message}${detail}`);
 		}
 	} else states.gitInitialized = true;
-	if (opts.createGithubRepository && !isUpdate) {
-		debug$1("Creating GitHub repository");
-		try {
-			debug$1("Executing: gh repo create %s --public --source=. --remote=origin", projectName);
-			await execa("gh", [
-				"repo",
-				"create",
-				projectName,
-				"--public",
-				"--source=.",
-				"--remote=origin"
-			], {
-				cwd: projectDir,
-				stdio,
-				preferLocal: true
-			});
-			log.success("Created GitHub repository (gh repo create).");
-			states.githubCreated = true;
-		} catch (e) {
-			debug$1("Failed to create GitHub repository: %O", e);
-			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
-			log.warn(`Failed to create GitHub repository: ${e.message}${detail}\nEnsure "gh" CLI is installed and authenticated.`);
-			states.githubError = e.message;
-		}
-	}
-	if (opts.installDependencies) {
+	if (opts.build) {
 		debug$1("Installing dependencies using %s", pm);
 		const s = spinner();
 		s.start(`Installing dependencies using ${pm}...`);
@@ -1379,6 +1363,51 @@ var generateProject = async (opts) => {
 			throw new Error(`Failed to run CI script: ${e.message}${detail}`);
 		}
 	}
+	if (opts.createGithubRepository && !isUpdate) {
+		debug$1("Creating and pushing GitHub repository");
+		const s = spinner();
+		s.start("Creating and pushing GitHub repository...");
+		try {
+			debug$1("Executing: git add .");
+			await execa("git", ["add", "."], {
+				cwd: projectDir,
+				stdio,
+				preferLocal: true
+			});
+			debug$1("Executing: git commit -m \"chore: initial scaffold\"");
+			await execa("git", [
+				"commit",
+				"-m",
+				"chore: initial scaffold"
+			], {
+				cwd: projectDir,
+				stdio,
+				preferLocal: true
+			});
+			debug$1("Executing: gh repo create %s --public --source=. --remote=origin --push", projectName);
+			await execa("gh", [
+				"repo",
+				"create",
+				projectName,
+				"--public",
+				"--source=.",
+				"--remote=origin",
+				"--push"
+			], {
+				cwd: projectDir,
+				stdio,
+				preferLocal: true
+			});
+			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Created GitHub repository and pushed initial commit.`);
+			states.githubCreated = true;
+		} catch (e) {
+			debug$1("Failed to create/push GitHub repository: %O", e);
+			s.stop("Failed to create/push GitHub repository.");
+			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
+			log.warn(`Failed to create/push GitHub repository: ${e.message}${detail}\nEnsure "gh" CLI is installed and authenticated.`);
+			states.githubError = e.message;
+		}
+	}
 	let hasErrors = false;
 	let hasWarnings = false;
 	const errorMessages = [];
@@ -1421,8 +1450,8 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		`- [x] Scaffold project files and directories`,
 		`- [x] Configure \`package.json\` with appropriate dependencies`,
 		`- [${states.depsInstalled ? "x" : " "}] Install dependencies using \`${pm}\`${states.depsSkipped ? " *(Skipped)*" : ""}`,
-		`- [${states.gitInitialized ? "x" : " "}] Initialize Git repository`,
-		`- [${states.githubCreated ? "x" : " "}] Create GitHub repository${states.githubSkipped ? " *(Skipped)*" : states.githubError ? " *(Failed)*" : ""}`,
+		`- [${states.gitInitialized ? "x" : " "}] Initialize Git repository (main branch)`,
+		`- [${states.githubCreated ? "x" : " "}] Create and push GitHub repository${states.githubSkipped ? " *(Skipped)*" : states.githubError ? " *(Failed)*" : ""}`,
 		`- [${states.ciRun ? "x" : " "}] Run initial CI pipeline (lint, build, test)${states.ciSkipped ? " *(Skipped)*" : ""}`,
 		"",
 		...isUpdate ? [
@@ -1519,19 +1548,17 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		"| `gh pr checkout <pr-number>` | Checkout a Pull Request branch locally |",
 		"| `gh issue create` | Create a new Issue |",
 		"| `gh issue list` | List all open Issues |",
-		"| `gh repo delete <owner>/<repo> --confirm` | Dangerously delete a repository completely (use with caution!) |",
+		"| `gh repo delete <owner>/<repo> --yes` | Dangerously delete a repository completely (use with caution!) |",
 		"",
 		"---",
 		"",
 		"## 🚀 Creating a Release",
 		"This project uses Conventional Commits and automated changelogs. To create a new release:",
-		"1. **Verify build/tests:** `pnpm run ci`",
-		"2. **Bump version:** `pnpm version <patch|minor|major> --no-git-tag-version`",
-		"3. **Update changelog:** `pnpm run create-changelog`",
-		"4. **Commit changes:** `git add . && git commit -m \"chore(release): $(node -p 'require(\"./package.json\").version')\"`",
-		"5. **Tag & Push:** `git tag v$(node -p 'require(\"./package.json\").version') && git push && git push --tags`",
-		"6. **Create GitHub Release:** `gh release create v$(node -p 'require(\"./package.json\").version') --generate-notes`",
-		"7. **Publish (if applicable):** `pnpm publish`",
+		"1. **Run the release command:** `pnpm release`",
+		"",
+		"This single command will automatically run your CI suite, bump the version, generate a changelog, create a Git tag, push to GitHub, and create a GitHub release.",
+		"",
+		"**Note:** NPM publishing is disabled by default. See `CONTRIBUTING.md` for details on how to enable it.",
 		"",
 		"---",
 		"",

package/dist/templates/base/files/.release-it.json

@@ -0,0 +1,23 @@
+{
+	"npm": {
+		"publish": false
+	},
+	"git": {
+		"requireCleanWorkingDir": true,
+		"commit": true,
+		"commitMessage": "chore(release): ${version}",
+		"tag": true,
+		"tagName": "v${version}",
+		"push": true,
+		"pushArgs": ["--follow-tags"]
+	},
+	"github": {
+		"release": true,
+		"autoGenerate": true
+	},
+	"hooks": {
+		"before:init": "pnpm run ci",
+		"after:bump": "pnpm run create-changelog",
+		"before:git:commit": "git add CHANGELOG.md"
+	}
+}

package/dist/templates/base/files/AGENTS.md

@@ -1,9 +1,86 @@
 # Agent Guidelines: {{projectName}}
 
-Build/Lint/Test:
+This document provides essential instructions for autonomous agents (like Cursor, GitHub Copilot, or CLI agents) working on the `{{projectName}}` repository.
+
+## Build/Lint/Test
+
 - `pnpm run ci`: Runs lint, build, and all tests.
 - `pnpm run dev`: Starts the development server.
-- `pnpm run test`: Runs unit tests (browser-based for web projects).
+- `pnpm run test`: Runs unit tests.
 - `pnpm run integration-test`: Runs integration tests.
 - `pnpm exec vitest <file>`: Runs a specific test file.
 - `pnpm run lint`: Lints and formats the codebase (oxlint + oxfmt).
+
+## Project Overview
+
+A modern project built with {{projectName}}, emphasizing type safety, performance, and best practices.
+
+## Build, Lint, and Test Commands
+
+### Core Commands
+
+- **Install dependencies:** `pnpm install`
+- **Build project:** `pnpm run build`
+- **Lint code:** `pnpm run lint` (runs `tsc`, `oxlint`, and `oxfmt`)
+- **Run all tests:** `pnpm run test` (uses `vitest` with coverage)
+- **Run CI suite:** `pnpm run ci` (lint + build + test)
+- **Run integration tests:** `pnpm run integration-test`
+
+### Targeted Testing
+
+- **Run a single test file:** `pnpm exec vitest src/index.test.ts`
+- **Run tests matching a pattern:** `pnpm exec vitest -t "feature"`
+- **Watch mode:** `pnpm exec vitest`
+
+## Code Style & Conventions
+
+### Language & Runtime
+
+- **TypeScript:** Strict mode is mandatory. Use explicit types for function boundaries.
+- **Node.js:** Targets >= 22.0.0.
+- **ESM:** The project uses ES Modules (`"type": "module"` in `package.json`).
+
+### Imports
+
+- **Extensions:** Always use `.js` extensions in relative imports (e.g., `import { main } from './lib.js';`) to comply with ESM requirements in Node.js, even though source files are `.ts`.
+- **Built-ins:** Use the `node:` prefix for built-in modules (e.g., `import path from 'node:path';`).
+
+### Formatting
+
+- **Tooling:** oxfmt is enforced via `pnpm run lint`.
+- **Indentation:** Tabs are used for indentation.
+- **Quotes:** Single quotes for strings, except when double quotes prevent escaping.
+
+### Architecture & Types
+
+- **Modularity:** Keep logic modularized.
+- **Type Safety:** Use `zod` for runtime schema validation and `z.infer` for type definitions.
+- **Immutability:** Prefer `readonly` and `const` where possible to ensure data integrity.
+
+### Naming Conventions
+
+- **Variables/Functions:** `camelCase`.
+- **Constants:** `UPPER_SNAKE_CASE`.
+- **Files:** `kebab-case.ts`.
+
+### Error Handling
+
+- **CLI Errors:** Throw descriptive errors.
+- **Safety:** Always use `try...finally` or `using` (if applicable) to ensure resources like file handles or connections are closed.
+- **Validation:** Validate all user inputs and CLI arguments using Zod schemas before processing.
+
+## Mandatory Completion Protocol (Definition of Done)
+
+No task involving code changes is considered complete until the agent provides the following "Evidence of Done" in its final response:
+
+1. **CI Verification:** The agent MUST run `pnpm run ci` and include the full terminal output (showing `Found 0 warnings and 0 errors` and `Tests passed`).
+2. **Test Coverage:** The agent MUST ensure that all new code is covered by tests and all existing tests pass.
+
+**Failure to provide these logs means the task is INCOMPLETE.** The user is encouraged to reject any response that lacks this section.
+
+## Git Workflow
+
+- **Conventional Commits:** Adhere to the specification (e.g., `feat:`, `fix:`, `chore:`, `test:`).
+- **Hooks:** Husky runs `pnpm run ci` on pre-commit. Do not bypass hooks.
+- **Branches:** Use descriptive branch names like `feat/feature-name` or `fix/issue-description`.
+

package/dist/templates/base/files/CONTRIBUTING.md

@@ -21,11 +21,22 @@ We follow the **Conventional Commits** specification. This is **enforced** by `c
 
 ## Release Process
 
-1. **Verify**: `pnpm run ci`
-2. **Bump Version**: `pnpm version <patch|minor|major> --no-git-tag-version`
-3. **Update Changelog**: `pnpm run create-changelog`
-4. **Commit**: `git add . && git commit -m "chore(release): $(node -p 'require("./package.json").version')"`
-5. **Tag & Push**: `git tag v$(node -p 'require("./package.json").version') && git push && git push --tags`
-6. **Create GitHub Release**: `gh release create v$(node -p 'require("./package.json").version') --generate-notes`
-7. **Publish**: `pnpm publish`
+To release a new version:
+
+```sh
+pnpm release -- patch   # or minor / major
+```
+
+This will automatically:
+1. Run the CI suite (`pnpm run ci`).
+2. Bump the version in `package.json`.
+3. Update the `CHANGELOG.md`.
+4. Commit, tag, and push the changes.
+5. Create a GitHub release with auto-generated notes.
+6. Publish to npm (if configured).
+
+**Note:** NPM publishing is **disabled** by default for new projects. To enable it:
+1. Set `"private": false` in `package.json`.
+2. Set `"publish": true` in `.release-it.json`.
+3. Ensure you have the necessary `NPM_TOKEN` configured.
 

package/dist/templates/base/files/_oxc.config.ts

@@ -1,6 +1,9 @@
 import { defineConfig } from "oxlint";
 import pluginRegexp from "eslint-plugin-regexp";
 
+/** Filter out core ESLint rules bundled into eslint-plugin-regexp recommended config */
+const regexpPluginRules = Object.fromEntries(Object.entries(pluginRegexp.configs.recommended.rules ?? {}).filter(([key]) => key.startsWith("regexp/")));
+
 const commonIgnore = [
   "**/.*",
   "node_modules/**",
@@ -32,7 +35,7 @@ export const linter = defineConfig({
     correctness: "error",
   },
   rules: {
-    ...pluginRegexp.configs.recommended.rules,
+    ...regexpPluginRules,
     curly: ["error", "all"],
     "typescript/no-unused-vars": [
       "error",

package/dist/templates/base/files/package.json

@@ -1,12 +1,14 @@
 {
   "name": "{{projectName}}",
   "version": "0.1.0",
+  "private": true,
   "type": "module",
   "scripts": {
     "lint": "tsc && oxlint --disable-nested-config src client server tests *.config.ts && npm run format:check",
     "format": "oxfmt --write .",
     "format:check": "oxfmt --check .",
     "test": "vitest run --coverage",
+    "release": "release-it",
     "ci": "npm run lint && npm run build && npm run test",
     "create-changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
     "prepare": "husky"
@@ -25,6 +27,7 @@
     "oxlint": "",
     "oxlint-tsgolint": "",
     "oxfmt": "",
+    "release-it": "",
     "eslint-plugin-regexp": "",
     "typescript": "",
     "vitest": ""

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "create-template-project",
-  "version": "1.0.0",
+  "version": "1.1.2",
+  "private": false,
   "description": "An ultra-modular, type-safe Node.js CLI tool used to scaffold new project templates (CLI, Webpage, Webapp, Fullstack) with best-practice configurations pre-installed.",
   "keywords": [
     "boilerplate",
@@ -54,17 +55,18 @@
     "format": "oxfmt --write src scripts *.config.ts",
     "format:check": "oxfmt --check src scripts *.config.ts",
     "test": "vitest run --coverage --exclude '**/*.integration.*.test.ts'",
-    "integration-test:cli": "rimraf ./temp/cli && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=cli --name=cli --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/cli",
-    "integration-test:web-vanilla": "rimraf ./temp/web-vanilla && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-vanilla --name=web-vanilla --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-vanilla",
-    "integration-test:web-app": "rimraf ./temp/web-app && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-app --name=web-app --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-app",
-    "integration-test:web-fullstack": "rimraf ./temp/web-fullstack && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-fullstack --name=web-fullstack --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-fullstack",
+    "integration-test:cli": "rimraf --max-retries=3 ./temp/cli && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=cli --name=cli --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/cli",
+    "integration-test:web-vanilla": "rimraf --max-retries=3 ./temp/web-vanilla && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-vanilla --name=web-vanilla --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-vanilla",
+    "integration-test:web-app": "rimraf --max-retries=3 ./temp/web-app && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-app --name=web-app --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-app",
+    "integration-test:web-fullstack": "rimraf --max-retries=3 ./temp/web-fullstack && node ./dist/index.js create --package-manager=pnpm --build --debug --no-progress --template=web-fullstack --name=web-fullstack --author=\"Jon Doe\" --github-username=\"jon-doe\" --path=./temp/web-fullstack",
     "integration-test": "pnpm run integration-test:cli && pnpm run integration-test:web-vanilla && pnpm run integration-test:web-app && pnpm run integration-test:web-fullstack",
     "ci": "pnpm run lint && pnpm run build && pnpm run test",
     "create-changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
-    "prepare": "husky"
+    "prepare": "husky",
+    "release": "release-it"
   },
   "dependencies": {
-    "@clack/prompts": "1.1.0",
+    "@clack/prompts": "1.2.0",
     "commander": "14.0.3",
     "debug": "4.4.3",
     "execa": "9.6.1",
@@ -75,19 +77,20 @@
     "@commitlint/config-conventional": "20.5.0",
     "@types/cli-progress": "3.11.6",
     "@types/debug": "4.1.13",
-    "@vitest/coverage-v8": "4.1.1",
+    "@vitest/coverage-v8": "4.1.2",
     "conventional-changelog": "7.2.0",
-    "conventional-changelog-angular": "8.3.0",
+    "conventional-changelog-angular": "8.3.1",
     "eslint-plugin-regexp": "3.1.0",
     "husky": "9.1.7",
-    "oxfmt": "0.41.0",
-    "oxlint": "1.56.0",
-    "oxlint-tsgolint": "0.17.1",
-    "pnpm": "10.32.1",
+    "oxfmt": "0.43.0",
+    "oxlint": "1.58.0",
+    "oxlint-tsgolint": "0.19.0",
+    "pnpm": "10.33.0",
+    "release-it": "19.2.4",
     "rimraf": "6.1.3",
-    "typescript": "5.9.3",
-    "vite": "8.0.2",
-    "vitest": "4.1.1"
+    "typescript": "6.0.2",
+    "vite": "8.0.3",
+    "vitest": "4.1.2"
   },
   "engines": {
     "node": ">=22"