create-template-project 0.5.0 → 1.0.0

package/README.md

@@ -22,9 +22,10 @@ pnpm dlx create-template-project interactive
 
 - **Modern Tech Stack:** All templates come with `commitlint`, `husky`, `vitest`, `oxlint`, `oxfmt`, and `typescript` (strict mode).
 - **Interactive CLI:** Prompts you for project details if CLI arguments are missing, using `@clack/prompts`.
-- **🔄 Update Mode:** Detects existing projects and offers a safe update path using `git merge-file`.
-  - Files in `src/` and all `*.md` files are skipped to protect your application logic and documentation.
-  - Ideal for keeping your project's boilerplate (linting, CI, configs) up-to-date.
+- **🔄 Update Mode:** Detects existing projects and offers a safe update path.
+  - **Intelligent Tracking:** Automatically generates a detailed `GENERATED.md` with an "Upgrade Details" table showing exactly what changed, why, and what actions (like conflict resolution) are needed.
+  - **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.
 - **CI Ready:** Generates GitHub Actions workflows for automated testing and linting.

package/dist/index.js

@@ -37,23 +37,8 @@ var ProjectOptionsSchema = z.object({
 	progress: z.boolean().optional().default(true)
 });
 //#endregion
-//#region src/utils/file.ts
-var debug$3 = debugLib("create-template-project:utils:file");
-function getTemplateDir(dirname, templateName) {
-	const sourcePath = path.resolve(dirname, "files");
-	const distPath = path.resolve(dirname, "templates", templateName, "files");
-	return existsSync(distPath) ? distPath : sourcePath;
-}
-async function getAllFiles(dirPath, arrayOfFiles = []) {
-	const files = await fs.readdir(dirPath);
-	for (const file of files) {
-		if (file === ".DS_Store") continue;
-		if ((await fs.stat(path.join(dirPath, file))).isDirectory()) arrayOfFiles = await getAllFiles(path.join(dirPath, file), arrayOfFiles);
-		else arrayOfFiles.push(path.join(dirPath, file));
-	}
-	return arrayOfFiles;
-}
-function processContent(filePath, content, opts, addedDeps) {
+//#region src/utils/templating/generic.ts
+var genericProcessor = (content, { opts }) => {
 	const { projectName, template, author, githubUsername } = opts;
 	let description = opts.description || "";
 	if (!description) switch (template) {
@@ -72,29 +57,105 @@ function processContent(filePath, content, opts, addedDeps) {
 	}
 	const pm = opts.packageManager || "npm";
 	const lockfileRules = pm === "pnpm" ? "package-lock.json\nyarn.lock" : pm === "yarn" ? "package-lock.json\npnpm-lock.yaml" : "yarn.lock\npnpm-lock.yaml";
-	let processed = content.replaceAll("{{projectName}}", projectName).replaceAll("{{description}}", description).replaceAll("{{packageManager}}", pm).replaceAll("{{author}}", author || "").replaceAll("{{githubUsername}}", githubUsername || "").replaceAll("{{year}}", (/* @__PURE__ */ new Date()).getFullYear().toString()).replaceAll("{{lockfileRules}}", lockfileRules);
-	if (filePath.includes(".github/workflows/node.js.yml")) {
-		let installCommand = "npm ci";
-		let pmSetup = "";
-		if (pm === "pnpm") {
-			installCommand = "pnpm install --frozen-lockfile";
-			pmSetup = "- uses: pnpm/action-setup@v4\n        with:\n          version: 9";
-		} else if (pm === "yarn") installCommand = "yarn install --frozen-lockfile";
-		let playwrightSetup = "";
-		if (template === "web-fullstack" || template === "web-app" || template === "web-vanilla") playwrightSetup = "- name: Install Playwright Browsers & Deps\n        run: npx playwright install --with-deps chromium";
-		processed = processed.replaceAll("{{installCommand}}", installCommand).replaceAll("# [PM_SETUP]", pmSetup).replaceAll("# [PLAYWRIGHT_SETUP]", playwrightSetup);
-		processed = processed.replace(/^\s*# \[PM_SETUP\]\s*\n/m, "");
-		processed = processed.replace(/^\s*# \[PLAYWRIGHT_SETUP\]\s*\n/m, "");
-	}
-	if (template === "web-vanilla" && filePath === "index.html") processed = processed.replace("{{scriptSrc}}", "/src/index.ts");
-	if (filePath === "CONTRIBUTING.md" && addedDeps.length > 0) {
-		processed += "\n## Dependencies\n\n";
-		const uniqueDeps = Array.from(new Set(addedDeps.map((d) => JSON.stringify(d)))).map((s) => JSON.parse(s));
-		for (const dep of uniqueDeps) processed += `- **${dep.name}**: ${dep.description}\n`;
-	}
-	if ((template === "web-fullstack" || template === "web-vanilla" || template === "web-app") && filePath === "tsconfig.json") processed = processed.replace(/\/\* Language and Environment \*\/[\s\S]*?\/\* Strict Type-Checking Options \*\//, "/* Language and Environment */\n		\"target\": \"ES2023\" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,\n		\"lib\": [\"ES2023\", \"DOM\", \"DOM.Iterable\"] /* Specify a set of bundled library declaration files that describe the target runtime environment. */,\n		\"module\": \"ESNext\" /* Specify what module code is generated. */,\n		\"moduleResolution\": \"bundler\" /* Specify how TypeScript looks up a file from a given module specifier. */,\n		\"esModuleInterop\": true /* Emit additional JavaScript to ease support for importing CommonJS modules. */,\n		\"resolveJsonModule\": true /* Enable importing .json files. */,\n		\"allowImportingTsExtensions\": true /* Allow imports to include TypeScript file extensions. */,\n		\"noEmit\": true /* Disable emitting files from a compilation. */,\n		\"jsx\": \"react-jsx\" /* Specify what JSX code is generated. */,\n\n		/* Strict Type-Checking Options */");
-	if (template === "web-fullstack" && filePath === "tsconfig.json") processed = processed.replace(/"include":\s*\[\s*"src\/\*\*\/\*"\s*\]/, "\"include\": [\"client/src/**/*\", \"server/src/**/*\"]");
+	return content.replaceAll("{{projectName}}", projectName).replaceAll("{{description}}", description).replaceAll("{{packageManager}}", pm).replaceAll("{{author}}", author || "").replaceAll("{{githubUsername}}", githubUsername || "").replaceAll("{{year}}", (/* @__PURE__ */ new Date()).getFullYear().toString()).replaceAll("{{lockfileRules}}", lockfileRules);
+};
+//#endregion
+//#region src/utils/templating/github-workflow.ts
+var WORKFLOW_PNPM_SETUP = `      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+          run_install: false`;
+var WORKFLOW_PLAYWRIGHT_SETUP = `      - name: Install Playwright Browsers & Deps
+        run: npx playwright install --with-deps chromium`;
+var githubWorkflowProcessor = (content, { filePath, opts }) => {
+	if (!filePath.includes(".github/workflows/node.js.yml")) return content;
+	const { template, packageManager: pm = "npm" } = opts;
+	let installCommand = "npm ci";
+	let pmSetup = "";
+	if (pm === "pnpm") {
+		installCommand = "pnpm install --frozen-lockfile";
+		pmSetup = WORKFLOW_PNPM_SETUP;
+	} else if (pm === "yarn") installCommand = "yarn install --frozen-lockfile";
+	let playwrightSetup = "";
+	if (template === "web-fullstack" || template === "web-app" || template === "web-vanilla") playwrightSetup = WORKFLOW_PLAYWRIGHT_SETUP;
+	let processed = content.replaceAll("{{installCommand}}", installCommand).replaceAll("# [PM_SETUP]", pmSetup).replaceAll("# [PLAYWRIGHT_SETUP]", playwrightSetup);
+	processed = processed.replace(/^\s*# \[PM_SETUP\]\s*\n/m, "");
+	processed = processed.replace(/^\s*# \[PLAYWRIGHT_SETUP\]\s*\n/m, "");
+	return processed;
+};
+//#endregion
+//#region src/utils/templating/tsconfig.ts
+var WEB_ENV = `/* Language and Environment */
+		"target": "ES2023" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+		"lib": ["ES2023", "DOM", "DOM.Iterable"] /* Specify a set of bundled library declaration files that describe the target runtime environment. */,
+		"module": "ESNext" /* Specify what module code is generated. */,
+		"moduleResolution": "bundler" /* Specify how TypeScript looks up a file from a given module specifier. */,
+		"esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. */,
+		"resolveJsonModule": true /* Enable importing .json files. */,
+		"allowImportingTsExtensions": true /* Allow imports to include TypeScript file extensions. */,
+		"noEmit": true /* Disable emitting files from a compilation. */,
+		"jsx": "react-jsx" /* Specify what JSX code is generated. */,`;
+var tsconfigProcessor = (content, { filePath, opts }) => {
+	if (filePath !== "tsconfig.json") return content;
+	const { template } = opts;
+	let processed = content;
+	if (template === "web-fullstack" || template === "web-vanilla" || template === "web-app") processed = processed.replace(/\/\* Language and Environment \*\/[\s\S]*?\/\* Strict Type-Checking Options \*\//, WEB_ENV + "\n\n		/* Strict Type-Checking Options */");
+	if (template === "web-fullstack") processed = processed.replace(/"include":\s*\[\s*"src\/\*\*\/\*"\s*\]/, "\"include\": [\"client/src/**/*\", \"server/src/**/*\"]");
+	return processed;
+};
+//#endregion
+//#region src/utils/templating/contributing.ts
+var contributingProcessor = (content, { filePath, addedDeps }) => {
+	if (filePath !== "CONTRIBUTING.md" || addedDeps.length === 0) return content;
+	let processed = content;
+	processed += "\n## Dependencies\n\n";
+	const uniqueDeps = Array.from(new Set(addedDeps.map((d) => JSON.stringify(d)))).map((s) => JSON.parse(s));
+	for (const dep of uniqueDeps) processed += `- **${dep.name}**: ${dep.description}\n`;
 	return processed;
+};
+//#endregion
+//#region src/utils/templating/web-vanilla-html.ts
+var webVanillaHtmlProcessor = (content, { filePath, opts }) => {
+	if (opts.template === "web-vanilla" && filePath === "index.html") return content.replace("{{scriptSrc}}", "/src/index.ts");
+	return content;
+};
+//#endregion
+//#region src/utils/templating/index.ts
+var processors = [
+	genericProcessor,
+	githubWorkflowProcessor,
+	tsconfigProcessor,
+	contributingProcessor,
+	webVanillaHtmlProcessor
+];
+function processContent$1(filePath, content, opts, addedDeps) {
+	const context = {
+		filePath,
+		opts,
+		addedDeps
+	};
+	return processors.reduce((acc, processor) => processor(acc, context), content);
+}
+//#endregion
+//#region src/utils/file.ts
+var debug$3 = debugLib("create-template-project:utils:file");
+function getTemplateDir(dirname, templateName) {
+	const sourcePath = path.resolve(dirname, "files");
+	const distPath = path.resolve(dirname, "templates", templateName, "files");
+	return existsSync(distPath) ? distPath : sourcePath;
+}
+async function getAllFiles(dirPath, arrayOfFiles = []) {
+	const files = await fs.readdir(dirPath);
+	for (const file of files) {
+		if (file === ".DS_Store") continue;
+		if ((await fs.stat(path.join(dirPath, file))).isDirectory()) arrayOfFiles = await getAllFiles(path.join(dirPath, file), arrayOfFiles);
+		else arrayOfFiles.push(path.join(dirPath, file));
+	}
+	return arrayOfFiles;
+}
+function processContent(filePath, content, opts, addedDeps) {
+	return processContent$1(filePath, content, opts, addedDeps);
 }
 function mergePackageJson(target, source) {
 	if (source.scripts) target.scripts = {
@@ -277,7 +338,7 @@ var getWebVanillaTemplate = (_opts) => {
 			preview: "vite preview",
 			test: "vitest run",
 			"test:ui": "vitest",
-			"test:e2e": "playwright test"
+			"integration-test": "playwright test"
 		},
 		files: [],
 		templateDir: getTemplateDir(__dirname$3, "web-vanilla")
@@ -343,7 +404,7 @@ var getWebAppTemplate = (_opts) => {
 			preview: "vite preview",
 			test: "vitest run",
 			"test:ui": "vitest",
-			"test:e2e": "playwright test",
+			"integration-test": "playwright test",
 			start: "vite preview"
 		},
 		files: [],
@@ -420,7 +481,7 @@ var getWebFullstackTemplate = (_opts) => {
 			build: "npm run build --workspaces",
 			dev: "npm run dev --workspaces",
 			test: "npm run test --workspaces",
-			"test:e2e": "playwright test"
+			"integration-test": "playwright test"
 		},
 		files: [],
 		templateDir: getTemplateDir(__dirname$1, "web-fullstack")
@@ -1007,7 +1068,8 @@ var generateProject = async (opts) => {
 				if (isUpdate && isSeedFile(relativePath)) {
 					actions.push({
 						type: "SKIP",
-						path: relativePath
+						path: relativePath,
+						reason: "Seed file - skipped during update to preserve manual changes"
 					});
 					continue;
 				}
@@ -1015,7 +1077,8 @@ var generateProject = async (opts) => {
 					if (isUpdate && await pathExists(targetPath)) {
 						actions.push({
 							type: "DELETE",
-							path: relativePath
+							path: relativePath,
+							reason: "File no longer required for this template type"
 						});
 						pendingOperations.push(async () => {
 							await fs.rm(targetPath, { force: true });
@@ -1035,21 +1098,36 @@ var generateProject = async (opts) => {
 				if (isUpdate && exists) {
 					const existingContent = await fs.readFile(finalTargetPath, "utf8");
 					if (existingContent.trim() !== content.trim()) {
-						actions.push({
+						const action = {
 							type: "MODIFY",
-							path: finalRelativePath
-						});
+							path: finalRelativePath,
+							reason: "Template tooling or configuration update"
+						};
+						actions.push(action);
 						pendingOperations.push(async () => {
 							const result = await mergeFile(finalTargetPath, existingContent, content, log);
-							if (result === "merged") log.info(`ℹ Merged: ${finalRelativePath}`);
-							else if (result === "conflict") log.warn(`⚠ Conflict: ${finalRelativePath}`);
-							else if (result === "updated") log.info(`✔ Updated: ${finalRelativePath}`);
+							if (result === "merged") {
+								action.type = "MERGE";
+								action.reason = "Merged template updates with your manual changes";
+								action.recommendedAction = "Review changes for correct integration";
+								log.info(`ℹ Merged: ${finalRelativePath}`);
+							} else if (result === "conflict") {
+								action.type = "CONFLICT";
+								action.reason = "Conflicting changes between template and your code";
+								action.recommendedAction = "Resolve git conflict markers in this file";
+								log.warn(`⚠ Conflict: ${finalRelativePath}`);
+							} else if (result === "updated") {
+								action.type = "UPDATED";
+								action.reason = "File was updated to the latest template version";
+								log.info(`✔ Updated: ${finalRelativePath}`);
+							}
 						});
 					}
 				} else if (!exists) {
 					actions.push({
 						type: "ADD",
-						path: finalRelativePath
+						path: finalRelativePath,
+						reason: "New template file added"
 					});
 					pendingOperations.push(async () => {
 						await fs.mkdir(path.dirname(finalTargetPath), { recursive: true });
@@ -1065,7 +1143,8 @@ var generateProject = async (opts) => {
 			if (isUpdate && isSeedFile(file.path)) {
 				actions.push({
 					type: "SKIP",
-					path: file.path
+					path: file.path,
+					reason: "Seed file - skipped during update to preserve manual changes"
 				});
 				continue;
 			}
@@ -1073,7 +1152,8 @@ var generateProject = async (opts) => {
 				if (isUpdate && await pathExists(targetPath)) {
 					actions.push({
 						type: "DELETE",
-						path: file.path
+						path: file.path,
+						reason: "File no longer required for this template type"
 					});
 					pendingOperations.push(async () => {
 						await fs.rm(targetPath, { force: true });
@@ -1087,21 +1167,36 @@ var generateProject = async (opts) => {
 			if (isUpdate && exists) {
 				const existingContent = await fs.readFile(targetPath, "utf8");
 				if (existingContent.trim() !== content.trim()) {
-					actions.push({
+					const action = {
 						type: "MODIFY",
-						path: file.path
-					});
+						path: file.path,
+						reason: "Template configuration update"
+					};
+					actions.push(action);
 					pendingOperations.push(async () => {
 						const result = await mergeFile(targetPath, existingContent, content, log);
-						if (result === "merged") log.info(`ℹ Merged: ${file.path}`);
-						else if (result === "conflict") log.warn(`⚠ Conflict: ${file.path}`);
-						else if (result === "updated") log.info(`✔ Updated: ${file.path}`);
+						if (result === "merged") {
+							action.type = "MERGE";
+							action.reason = "Merged template updates with your manual changes";
+							action.recommendedAction = "Review changes for correct integration";
+							log.info(`ℹ Merged: ${file.path}`);
+						} else if (result === "conflict") {
+							action.type = "CONFLICT";
+							action.reason = "Conflicting changes between template and your code";
+							action.recommendedAction = "Resolve git conflict markers in this file";
+							log.warn(`⚠ Conflict: ${file.path}`);
+						} else if (result === "updated") {
+							action.type = "UPDATED";
+							action.reason = "File was updated to the latest template version";
+							log.info(`✔ Updated: ${file.path}`);
+						}
 					});
 				}
 			} else if (!exists) {
 				actions.push({
 					type: "ADD",
-					path: file.path
+					path: file.path,
+					reason: "New template file added"
 				});
 				pendingOperations.push(async () => {
 					await fs.mkdir(path.dirname(targetPath), { recursive: true });
@@ -1124,7 +1219,8 @@ var generateProject = async (opts) => {
 		if (workspaceChanged) {
 			actions.push({
 				type: workspaceExists ? "MODIFY" : "ADD",
-				path: "pnpm-workspace.yaml"
+				path: "pnpm-workspace.yaml",
+				reason: "Updated workspace configuration for pnpm"
 			});
 			pendingOperations.push(async () => {
 				await fs.writeFile(workspacePath, workspaceYaml);
@@ -1142,11 +1238,13 @@ var generateProject = async (opts) => {
 	if (pkgChanged) {
 		if (isUpdate) actions.push({
 			type: "MODIFY",
-			path: "package.json"
+			path: "package.json",
+			reason: "Updated dependencies and scripts to match latest template"
 		});
 		else actions.push({
 			type: "ADD",
-			path: "package.json"
+			path: "package.json",
+			reason: "Initial project configuration"
 		});
 		pendingOperations.push(async () => {
 			debug$1("Writing final consolidated package.json to: %s", pkgPath);
@@ -1292,12 +1390,12 @@ var generateProject = async (opts) => {
 		hasErrors,
 		hasWarnings,
 		errorMessages
-	});
+	}, actions);
 	const successMsg = `Project "${projectName}" ${isUpdate ? "updated" : "scaffolded"} successfully in ${projectDir}. A detailed setup guide has been generated at GENERATED.md`;
 	if (hasWarnings) log.warn(`${successMsg} (completed with warnings)`);
 	else log.success(successMsg);
 };
-async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, status) {
+async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, status, actions) {
 	const statusBadge = status.hasErrors ? "🔴 **Completed with Errors**" : status.hasWarnings ? "🟡 **Completed with Warnings**" : "🟢 **Successfully Completed**";
 	const md = [
 		`# 🚀 Project Setup Guide: ${opts.projectName}`,
@@ -1319,7 +1417,7 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		"---",
 		"",
 		"## 📋 Initialization Checklist",
-		"The following tasks were executed during the generation process:",
+		isUpdate ? "The project was updated with the latest template changes:" : "The following tasks were executed during the generation process:",
 		`- [x] Scaffold project files and directories`,
 		`- [x] Configure \`package.json\` with appropriate dependencies`,
 		`- [${states.depsInstalled ? "x" : " "}] Install dependencies using \`${pm}\`${states.depsSkipped ? " *(Skipped)*" : ""}`,
@@ -1327,6 +1425,41 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		`- [${states.githubCreated ? "x" : " "}] Create GitHub repository${states.githubSkipped ? " *(Skipped)*" : states.githubError ? " *(Failed)*" : ""}`,
 		`- [${states.ciRun ? "x" : " "}] Run initial CI pipeline (lint, build, test)${states.ciSkipped ? " *(Skipped)*" : ""}`,
 		"",
+		...isUpdate ? [
+			"### 🛠️ Upgrade Details",
+			"The following files were affected by this update:",
+			"",
+			"| File Path | Action | Reason | Next Steps |",
+			"| :--- | :--- | :--- | :--- |",
+			...actions.filter((a) => a.type !== "SKIP").map((a) => {
+				const actionIcon = {
+					ADD: "➕ ADD",
+					MODIFY: "📝 MODIFY",
+					MERGE: "🔀 MERGE",
+					CONFLICT: "🔥 CONFLICT",
+					DELETE: "🗑️ DELETE",
+					UPDATED: "✨ UPDATED"
+				}[a.type] || a.type;
+				return `| \`${a.path}\` | ${actionIcon} | ${a.reason || "-"} | ${a.recommendedAction || (a.type === "CONFLICT" ? "**Resolve conflicts**" : "Review changes")} |`;
+			}),
+			""
+		] : [],
+		"---",
+		"",
+		"## 🛠️ Manual Adjustments Needed",
+		"To complete your project setup, please review and manually update the following:",
+		"- [ ] **`LICENSE`**: Verify the copyright year and author name.",
+		"- [ ] **`package.json`**: Review the description, keywords, author, and repository links.",
+		"- [ ] **`README.md`**: Update with project-specific instructions, architecture details, and contribution guidelines.",
+		"- [ ] **`.gitignore`**: Note that there is a **`# Custom`** section at the end of the file for your own ignores.",
+		"",
+		"---",
+		"",
+		"## 💡 Next Steps",
+		"1. Review the generated codebase to familiarize yourself with the structure.",
+		`2. Start the development server using \`${pm} run dev\`.`,
+		"3. Make your first commit and push to your remote repository.",
+		"",
 		"---",
 		"",
 		"## 💻 Available Commands",
@@ -1402,19 +1535,6 @@ async function generateGeneratedMd(projectDir, opts, pm, states, isUpdate, statu
 		"",
 		"---",
 		"",
-		"## 🛠️ Manual Adjustments Needed",
-		"To complete your project setup, please review and manually update the following:",
-		"- [ ] **`LICENSE`**: Verify the copyright year and author name.",
-		"- [ ] **`package.json`**: Review the description, keywords, author, and repository links.",
-		"- [ ] **`README.md`**: Update with project-specific instructions, architecture details, and contribution guidelines.",
-		"",
-		"---",
-		"",
-		"## 💡 Next Steps",
-		"1. Review the generated codebase to familiarize yourself with the structure.",
-		`2. Start the development server using \`${pm} run dev\`.`,
-		"3. Make your first commit and push to your remote repository.",
-		"",
 		"<br>",
 		"<p align=\"center\"><i>This file was auto-generated by <b>create-template-project</b>.</i></p>"
 	].join("\n");

package/dist/templates/base/files/.github/workflows/node.js.yml

@@ -2,23 +2,49 @@ name: Node.js CI
 
 on:
   push:
-    branches: [main, master]
+    branches: [main]
   pull_request:
-    branches: [main, master]
+    branches: [main]
 
 jobs:
   build:
     runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x, 24.x]
+
     steps:
-      - uses: actions/checkout@v4
-      # [PM_SETUP]
-      - name: Use Node.js
+      - name: Checkout
+        uses: actions/checkout@v4
+
+# [PM_SETUP]
+
+      - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "22.x"
+          node-version: ${{ matrix.node-version }}
           cache: "{{packageManager}}"
-      - run: "{{installCommand}}"
-      # [PLAYWRIGHT_SETUP]
-      - run: "{{packageManager}} run ci"
+
+      - name: Verify {{packageManager}}
+        run: {{packageManager}} --version
+
+      - name: Install dependencies
+        run: {{installCommand}}
+
+# [PLAYWRIGHT_SETUP]
+
+      - name: Lint
+        run: {{packageManager}} run lint
+
+      - name: Build
+        run: {{packageManager}} run build
+
+      - name: Unit test
+        run: {{packageManager}} run test
+
       - name: Coveralls GitHub Action
         uses: coverallsapp/github-action@v2
+
+      - name: Integration test
+        run: {{packageManager}} run integration-test

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

@@ -4,6 +4,6 @@ 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:e2e`: Runs Playwright E2E 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).

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

@@ -17,7 +17,7 @@ This project is built using **Vite 8** for high-performance development and bund
 - `pnpm run build`: Builds the project for production.
 - `pnpm run preview`: Previews the production build.
 - `pnpm run test`: Runs the unit test suite (browser-based for web targets using **Vitest** and **Playwright**).
-- `pnpm run test:e2e`: Runs E2E tests using **Playwright**.
+- `pnpm run integration-test`: Runs integration tests using **Playwright**.
 - `pnpm run lint`: Lints and formats the codebase using **oxlint** and **oxfmt**.
 - `pnpm run ci`: Full CI pipeline (lint, build, test).
 
@@ -34,7 +34,7 @@ This project is built using **Vite 8** for high-performance development and bund
 3. **Run tests**:
    ```bash
    pnpm run test
-   pnpm run test:e2e
+   pnpm run integration-test
    ```
 
 ## Tooling

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

@@ -4,7 +4,7 @@ export default defineConfig({
 	test: {
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 			include: ['src/**/*.ts', 'src/**/*.tsx'],
 			exclude: ['src/**/*.test.ts', 'src/**/*.test.tsx', 'src/**/*.d.ts'],
 		},

package/dist/templates/cli/files/package.json

@@ -10,6 +10,7 @@
 	},
 	"scripts": {
 		"dev": "vite build --watch",
-		"build": "vite build"
+		"build": "vite build",
+		"integration-test": "node -e \"\""
 	}
 }

package/dist/templates/cli/files/vite.config.ts

@@ -16,7 +16,7 @@ export default defineConfig({
 	test: {
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 		},
 	},
 });

package/dist/templates/web-app/files/vite.config.ts

@@ -13,7 +13,7 @@ export default defineConfig({
 		include: ['src/**/*.test.{ts,tsx}'],
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 		},
 		browser: {
 			enabled: true,

package/dist/templates/web-fullstack/files/client/vite.config.ts

@@ -9,7 +9,7 @@ export default defineConfig({
 		include: ['src/**/*.test.{ts,tsx}'],
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 		},
 		browser: {
 			enabled: true,

package/dist/templates/web-fullstack/files/package.json

@@ -29,6 +29,6 @@
 	"scripts": {
 		"build": "npm run build --workspaces",
 		"dev": "npm run dev --workspaces",
-		"test:e2e": "playwright test"
+		"integration-test": "playwright test"
 	}
 }

package/dist/templates/web-fullstack/files/server/vite.config.ts

@@ -18,7 +18,7 @@ export default defineConfig({
 		environment: 'node',
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 		},
 	},
 });

package/dist/templates/web-vanilla/files/package.json

@@ -12,6 +12,6 @@
 		"preview": "vite preview",
 		"test": "vitest run",
 		"test:ui": "vitest",
-		"test:e2e": "playwright test"
+		"integration-test": "playwright test"
 	}
 }

package/dist/templates/web-vanilla/files/vite.config.ts

@@ -7,7 +7,7 @@ export default defineConfig({
 		include: ['src/**/*.test.ts'],
 		coverage: {
 			provider: 'v8',
-			reporter: ['text', 'json', 'html'],
+			reporter: ['text', 'json', 'html', 'lcov'],
 		},
 		browser: {
 			enabled: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-template-project",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "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",
@@ -58,7 +58,7 @@
     "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:all": "pnpm run integration-test:cli && pnpm run integration-test:web-vanilla && pnpm run integration-test:web-app && pnpm run integration-test: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"