create-template-project 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,7 @@
 [![Node.js CI](https://github.com/doberkofler/create-template-project/actions/workflows/node.js.yml/badge.svg)](https://github.com/doberkofler/create-template-project/actions/workflows/node.js.yml)
 [![Coverage Status](https://coveralls.io/repos/github/doberkofler/create-template-project/badge.svg?branch=master)](https://coveralls.io/github/doberkofler/create-template-project?branch=master)
 
-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.
+An ultra-modular, type-safe Node.js CLI tool used to scaffold new project templates (CLI, Web-Vanilla, Web-App, Web-Fullstack) with best-practice configurations pre-installed.
 
 ## Features
 
@@ -63,12 +63,12 @@ create-template-project update --template cli --name existing-project
 
 #### Command Options (create/update):
 
-- `-t, --template <type>`: Template type (`cli`, `webpage`, `webapp`, `fullstack`)
+- `-t, --template <type>`: Template type (`cli`, `web-vanilla`, `web-app`, `web-fullstack`)
 - `-n, --name <name>`: Project name
 - `--github`: Create GitHub project (requires `gh` CLI authenticated)
 - `-d, --directory <path>`: Output directory (defaults to `.`)
 - `--overwrite`: Overwrite existing directory by removing it first (create & update)
-- `--no-build`: Create a project without a build step (not allowed for `webapp`)
+- `--no-build`: Create a project without a build step (not allowed for `web-app`)
 - `--silent`: Reduce console output (useful for CI and scripts)
 
 ## Project Templates
@@ -76,16 +76,16 @@ create-template-project update --template cli --name existing-project
 ### 🟢 CLI
 A clean Node.js CLI environment featuring `commander` and `cli-progress`. Supports optional `tsdown` bundling.
 
-### 🔵 Webpage
+### 🔵 Web-Vanilla
 Standalone web page setup for modern browsers. Can be used with or without a build step.
 
-### 🟡 Webapp
-Classic web application structure with a `frontend/` and a `backend/` Express server. Built with TypeScript.
+### 🟡 Web-App
+Modern React application featuring MUI components and TanStack Query for state management.
 
-### ⚛️ Fullstack
+### ⚛️ Web-Fullstack
 A full-stack monorepo featuring:
 - **Client**: React with MUI (including Icons) and TypeScript.
-- **Server**: Express.js backend.
+- **Server**: Express.js backend with tRPC for end-to-end type safety.
 - **E2E**: Playwright for end-to-end testing.
 
 ## Contributing

package/dist/cli.mjs

@@ -1,4 +1,5 @@
-import { ProjectOptionsSchema } from "./types.mjs";
+import { ProjectOptionsSchema, TemplateTypeSchema } from "./types.mjs";
+import { getAllTemplatesInfo, getTemplateInfo } from "./generators/info.mjs";
 import { Command } from "commander";
 import * as p from "@clack/prompts";
 import path from "node:path";
@@ -15,19 +16,54 @@ const parseArgs = async () => {
 		writeErr: () => {}
 	});
 	program.name("create-template-project").exitOverride().description("Scaffold a new project template").version("0.1.0").option("--debug", "Enable debug output").on("option:debug", () => {
+		process.env["DEBUG"] = "create-template-project:*";
 		debugLib.enable("create-template-project:*");
 	}).addHelpText("after", `
+Commands:
+  create      - Create a new project from a template.
+  update      - Update an existing project from its template.
+  interactive - Start interactive project configuration.
+  info        - Show detailed information about available templates and components.
+
 Templates:
-  cli         - Node.js CLI application with commander and cli-progress.
-  webpage     - Standalone web page (modern HTML/JS).
-  webapp      - Web application with TypeScript and an Express backend.
-  fullstack   - Full-stack monorepo with Express server and React/MUI client.
+  cli            - Node.js CLI application with commander and cli-progress.
+  web-vanilla    - Standalone web page (modern HTML/JS).
+  web-app        - React application with MUI and TanStack Query.
+  web-fullstack  - Full-stack monorepo with Express server and React/MUI client.
 `);
 	let commandResult;
-	program.command("create").description("Create a new project from a template").option("-t, --template <type>", "Template type (cli, webpage, webapp, fullstack)").option("-n, --name <name>", "Project name").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "npm").option("--create-github-repository", "Create GitHub project").option("-d, --directory <path>", "Output directory", ".").option("--overwrite", "Overwrite existing directory by removing it first", false).option("--skip-build", "Skip build tooling (disables bundling and uses raw source files)", false).option("--install-dependencies", "Install dependencies after scaffolding", false).option("--build", "Run the CI script (lint, build, test) after scaffolding", false).option("--dev", "Run the dev server after scaffolding", false).option("--open", "Open the browser after scaffolding", false).option("--silent", "Reduce console output", false).action((opts) => {
+	program.command("info").description("Show detailed information about available templates and their components").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").action((opts) => {
+		debug("Executing \"info\" command with options: %O", opts);
+		p.intro("Template Information");
+		if (opts.template) {
+			const typeResult = TemplateTypeSchema.safeParse(opts.template);
+			if (!typeResult.success) {
+				p.log.error(`Invalid template type: ${opts.template}. Must be one of: cli, web-vanilla, web-app, web-fullstack`);
+				process.exit(1);
+			}
+			const info = getTemplateInfo(typeResult.data);
+			p.note([
+				`Description: ${info.description}`,
+				"",
+				"Components:",
+				...info.components.map((c) => `  ● ${c.name}: ${c.description}`)
+			].join("\n"), `Template: ${info.name}`);
+		} else {
+			const allInfo = getAllTemplatesInfo();
+			for (const info of allInfo) p.note([
+				`Description: ${info.description}`,
+				"",
+				"Components:",
+				...info.components.map((c) => `  ● ${c.name}: ${c.description}`)
+			].join("\n"), `Template: ${info.name}`);
+		}
+		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("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "npm").option("--create-github-repository", "Create GitHub project").option("-d, --directory <path>", "Output directory", ".").option("--overwrite", "Overwrite existing directory by removing it first", false).option("--skip-build", "Skip build tooling (disables bundling and uses raw source files)", false).option("--install-dependencies", "Install dependencies after scaffolding", false).option("--build", "Run the CI script (lint, build, test) after scaffolding", false).option("--dev", "Run the dev server after scaffolding", false).option("--open", "Open the browser after scaffolding", false).option("--silent", "Reduce console output", false).action((opts) => {
 		debug("Executing \"create\" command with options: %O", opts);
-		if (opts.template === "webapp" && opts.skipBuild) {
-			p.log.error("The --skip-build option is not allowed for the \"webapp\" template.");
+		if (opts.template === "web-app" && opts.skipBuild) {
+			p.log.error("The --skip-build option is not allowed for the \"web-app\" template.");
 			process.exit(1);
 		}
 		commandResult = {
@@ -43,10 +79,10 @@ Templates:
 		};
 		debug("Processed \"create\" options: %O", commandResult);
 	});
-	program.command("update").description("Update an existing project from its template").option("-t, --template <type>", "Template type (cli, webpage, webapp, fullstack)").option("-n, --name <name>", "Project name").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "npm").option("--create-github-repository", "Create GitHub project").option("-d, --directory <path>", "Output directory", ".").option("--overwrite", "Overwrite existing directory by removing it first", false).option("--skip-build", "Skip build tooling (disables bundling and uses raw source files)", false).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("--silent", "Reduce console output", false).action((opts) => {
+	program.command("update").description("Update an existing project from its template").option("-t, --template <type>", "Template type (cli, web-vanilla, web-app, web-fullstack)").option("-n, --name <name>", "Project name").option("-p, --package-manager <pm>", "Package manager (npm, pnpm, yarn)", "npm").option("--create-github-repository", "Create GitHub project").option("-d, --directory <path>", "Output directory", ".").option("--overwrite", "Overwrite existing directory by removing it first", false).option("--skip-build", "Skip build tooling (disables bundling and uses raw source files)", false).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("--silent", "Reduce console output", false).action((opts) => {
 		debug("Executing \"update\" command with options: %O", opts);
-		if (opts.template === "webapp" && opts.skipBuild) {
-			p.log.error("The --skip-build option is not allowed for the \"webapp\" template.");
+		if (opts.template === "web-app" && opts.skipBuild) {
+			p.log.error("The --skip-build option is not allowed for the \"web-app\" template.");
 			process.exit(1);
 		}
 		commandResult = {
@@ -131,16 +167,16 @@ Templates:
 						value: "cli"
 					},
 					{
-						label: "Webpage (Standalone)",
-						value: "webpage"
+						label: "Web-Vanilla (Standalone)",
+						value: "web-vanilla"
 					},
 					{
-						label: "Webapp (Express Backend)",
-						value: "webapp"
+						label: "Web-App (React + MUI)",
+						value: "web-app"
 					},
 					{
-						label: "Full-stack (Express + React/MUI Monorepo)",
-						value: "fullstack"
+						label: "Web-Fullstack (Express + React Monorepo)",
+						value: "web-fullstack"
 					}
 				]
 			});
@@ -175,7 +211,7 @@ Templates:
 			}
 		}
 		let skipBuild = false;
-		if (template !== "webapp") {
+		if (template !== "web-app") {
 			const res = await p.confirm({
 				message: "Should we use build tooling? (Enables bundling using tsdown, and uses raw dist/ instead of src/)",
 				initialValue: true

package/dist/config/dependencies.json

@@ -1,155 +1,175 @@
 {
 	"dependencies": {
+		"vite": {
+			"version": "8.0.1",
+			"description": "Native-ESM powered web dev build tool"
+		},
+		"@vitejs/plugin-react": {
+			"version": "6.0.1",
+			"description": "The default Vite plugin for React projects."
+		},
+		"@vitest/browser": {
+			"version": "4.1.0",
+			"description": "Run Vitest in the browser."
+		},
+		"@vitest/browser-playwright": {
+			"version": "4.1.0",
+			"description": "Playwright provider for Vitest browser mode."
+		},
+		"playwright": {
+			"version": "1.58.2",
+			"description": "Framework for Web-browser automation."
+		},
 		"debug": {
-			"version": "^4.4.3",
+			"version": "4.4.3",
 			"description": "A tiny JavaScript debugging utility modelled after Node.js core debugging technique."
 		},
 		"@commitlint/cli": {
-			"version": "^20.4.4",
+			"version": "20.5.0",
 			"description": "Lint commit messages to ensure they follow conventional commits."
 		},
 		"@commitlint/config-conventional": {
-			"version": "^20.4.4",
+			"version": "20.5.0",
 			"description": "Shareable commitlint config enforcing conventional commits."
 		},
 		"@types/debug": {
-			"version": "^4.1.12",
+			"version": "^4.1.13",
 			"description": "TypeScript definitions for debug."
 		},
 		"@types/node": {
-			"version": "^25.5.0",
+			"version": "25.5.0",
 			"description": "TypeScript definitions for Node.js."
 		},
 		"@vitest/coverage-v8": {
-			"version": "^4.1.0",
+			"version": "4.1.0",
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
-			"version": "^7.2.0",
+			"version": "7.2.0",
 			"description": "Generate a changelog from git metadata."
 		},
 		"husky": {
-			"version": "^9.1.7",
+			"version": "9.1.7",
 			"description": "Modern native git hooks made easy."
 		},
 		"oxlint": {
-			"version": "^1.55.0",
+			"version": "1.56.0",
 			"description": "A JavaScript linter written in Rust."
 		},
 		"oxlint-tsgolint": {
-			"version": "^0.16.0",
+			"version": "0.17.0",
 			"description": "TypeScript-specific rules for oxlint."
 		},
 		"prettier": {
-			"version": "^3.8.1",
+			"version": "3.8.1",
 			"description": "An opinionated code formatter."
 		},
 		"typescript": {
-			"version": "^5.9.3",
+			"version": "5.9.3",
 			"description": "A superset of JavaScript that compiles to clean JavaScript output."
 		},
 		"vitest": {
-			"version": "^4.1.0",
+			"version": "4.1.0",
 			"description": "A Vite-native unit test framework."
 		},
 		"commander": {
-			"version": "^14.0.3",
+			"version": "14.0.3",
 			"description": "The complete solution for node.js command-line interfaces."
 		},
 		"cli-progress": {
-			"version": "^3.12.0",
+			"version": "3.12.0",
 			"description": "Easy to use progress-bar for command-line/terminal applications."
 		},
 		"@types/cli-progress": {
-			"version": "^3.11.6",
+			"version": "3.11.6",
 			"description": "TypeScript definitions for cli-progress."
 		},
 		"tsdown": {
-			"version": "^0.21.2",
+			"version": "0.21.4",
 			"description": "A zero-config bundler for TypeScript."
 		},
 		"express": {
-			"version": "^5.2.1",
+			"version": "5.2.1",
 			"description": "Fast, unopinionated, minimalist web framework for Node.js."
 		},
 		"@types/express": {
-			"version": "^5.0.6",
+			"version": "5.0.6",
 			"description": "TypeScript definitions for Express."
 		},
 		"react": {
-			"version": "^19.2.4",
+			"version": "19.2.4",
 			"description": "A JavaScript library for building user interfaces."
 		},
 		"react-dom": {
-			"version": "^19.2.4",
+			"version": "19.2.4",
 			"description": "React package for working with the DOM."
 		},
 		"@mui/material": {
-			"version": "^7.3.9",
+			"version": "7.3.9",
 			"description": "Material UI components."
 		},
 		"@mui/icons-material": {
-			"version": "^7.3.9",
+			"version": "7.3.9",
 			"description": "Material Design icons distributed as SVG React components."
 		},
 		"@emotion/react": {
-			"version": "^11.14.0",
+			"version": "11.14.0",
 			"description": "CSS-in-JS library designed for high performance."
 		},
 		"@emotion/styled": {
-			"version": "^11.14.1",
+			"version": "11.14.1",
 			"description": "Styled components for Emotion."
 		},
 		"@types/react": {
-			"version": "^19.2.14",
+			"version": "19.2.14",
 			"description": "TypeScript definitions for React."
 		},
 		"@types/react-dom": {
-			"version": "^19.2.3",
+			"version": "19.2.3",
 			"description": "TypeScript definitions for React DOM."
 		},
 		"@playwright/test": {
-			"version": "^1.58.2",
+			"version": "1.58.2",
 			"description": "End-to-end testing framework."
 		},
 		"@trpc/server": {
-			"version": "^11.12.0",
+			"version": "11.13.4",
 			"description": "tRPC server library."
 		},
 		"@trpc/client": {
-			"version": "^11.12.0",
+			"version": "11.13.4",
 			"description": "tRPC client library."
 		},
 		"@trpc/react-query": {
-			"version": "^11.12.0",
+			"version": "11.13.4",
 			"description": "tRPC integration for React Query."
 		},
 		"@tanstack/react-query": {
-			"version": "^5.90.21",
+			"version": "^5.91.2",
 			"description": "Powerful asynchronous state management for TS/JS."
 		},
 		"zod": {
-			"version": "^4.3.6",
+			"version": "4.3.6",
 			"description": "TypeScript-first schema validation with static type inference."
 		},
 		"tinyexec": {
-			"version": "^1.0.4",
-			"description": "A minimal library for executing processes in Node (pinned to 1.0.2 due to broken 1.0.3 release)."
+			"version": "1.0.4",
+			"description": "A minimal library for executing processes in Node."
 		},
 		"react-router-dom": {
-			"version": "^7.13.1",
+			"version": "7.13.1",
 			"description": "Declarative routing for React web applications."
 		},
 		"cors": {
-			"version": "^2.8.6",
+			"version": "2.8.6",
 			"description": "Node.js CORS middleware."
 		},
 		"@types/cors": {
-			"version": "^2.8.19",
+			"version": "2.8.19",
 			"description": "TypeScript definitions for cors."
 		},
 		"eslint-plugin-regexp": {
-			"version": "^3.1.0",
+			"version": "3.1.0",
 			"description": "ESLint plugin for finding regexp mistakes and style guide violations."
 		}
 	}

package/dist/generators/info.mjs

@@ -0,0 +1,58 @@
+import { getBaseTemplate } from "../templates/base/index.mjs";
+import { getCliTemplate } from "../templates/cli/index.mjs";
+import { getWebVanillaTemplate } from "../templates/web-vanilla/index.mjs";
+import { getWebAppTemplate } from "../templates/web-app/index.mjs";
+import { getWebFullstackTemplate } from "../templates/web-fullstack/index.mjs";
+//#region src/generators/info.ts
+const MOCK_OPTS = {
+	template: "cli",
+	projectName: "mock",
+	directory: ".",
+	packageManager: "npm",
+	overwrite: false,
+	update: false,
+	skipBuild: false,
+	installDependencies: false,
+	build: false,
+	dev: false,
+	open: false,
+	silent: true,
+	createGithubRepository: false
+};
+const getTemplateInfo = (type) => {
+	const opts = {
+		...MOCK_OPTS,
+		template: type
+	};
+	const base = getBaseTemplate(opts);
+	let template;
+	switch (type) {
+		case "cli":
+			template = getCliTemplate(opts);
+			break;
+		case "web-vanilla":
+			template = getWebVanillaTemplate(opts);
+			break;
+		case "web-app":
+			template = getWebAppTemplate(opts);
+			break;
+		case "web-fullstack":
+			template = getWebFullstackTemplate(opts);
+			break;
+	}
+	return {
+		name: template.name,
+		description: template.description,
+		components: [...base.components, ...template.components]
+	};
+};
+const getAllTemplatesInfo = () => {
+	return [
+		"cli",
+		"web-vanilla",
+		"web-app",
+		"web-fullstack"
+	].map((type) => getTemplateInfo(type));
+};
+//#endregion
+export { getAllTemplatesInfo, getTemplateInfo };

package/dist/generators/project.mjs

@@ -1,8 +1,8 @@
 import { getBaseTemplate } from "../templates/base/index.mjs";
 import { getCliTemplate } from "../templates/cli/index.mjs";
-import { getWebpageTemplate } from "../templates/webpage/index.mjs";
-import { getWebappTemplate } from "../templates/webapp/index.mjs";
-import { getFullstackTemplate } from "../templates/fullstack/index.mjs";
+import { getWebVanillaTemplate } from "../templates/web-vanilla/index.mjs";
+import { getWebAppTemplate } from "../templates/web-app/index.mjs";
+import { getWebFullstackTemplate } from "../templates/web-fullstack/index.mjs";
 import { getAllFiles, isSeedFile, mergeFile, mergePackageJson, processContent } from "../utils/file.mjs";
 import * as p from "@clack/prompts";
 import path from "node:path";
@@ -29,7 +29,11 @@ const getSpinner = (silent) => {
 		message: (msg) => !silent ? s.message(msg) : void 0
 	};
 };
-const showNote = (msg, title, silent) => !silent ? p.note(msg, title) : void 0;
+const showNote = (msg, title, silent) => {
+	if (silent) return;
+	if (title) p.log.success(title);
+	p.note(msg);
+};
 const generateProject = async (opts) => {
 	const { template: type, projectName, directory, update, overwrite, skipBuild, silent } = opts;
 	const isSilent = !!silent;
@@ -56,17 +60,17 @@ const generateProject = async (opts) => {
 			debug("Applying template: cli");
 			templates.push(getCliTemplate(opts));
 			break;
-		case "webpage":
-			debug("Applying template: webpage");
-			templates.push(getWebpageTemplate(opts));
+		case "web-vanilla":
+			debug("Applying template: web-vanilla");
+			templates.push(getWebVanillaTemplate(opts));
 			break;
-		case "webapp":
-			debug("Applying template: webapp");
-			templates.push(getWebappTemplate(opts));
+		case "web-app":
+			debug("Applying template: web-app");
+			templates.push(getWebAppTemplate(opts));
 			break;
-		case "fullstack":
-			debug("Applying template: fullstack");
-			templates.push(getFullstackTemplate(opts));
+		case "web-fullstack":
+			debug("Applying template: web-fullstack");
+			templates.push(getWebFullstackTemplate(opts));
 			break;
 	}
 	debug("Ensuring directory exists: %s", projectDir);
@@ -124,6 +128,7 @@ const generateProject = async (opts) => {
 		Object.assign(finalPkg.scripts, t.scripts);
 		Object.assign(finalPkg.dependencies, templateDeps);
 		Object.assign(finalPkg.devDependencies, templateDevDeps);
+		if (t.workspaces) finalPkg.workspaces = t.workspaces;
 		if (t.templateDir) {
 			const templatePkgPath = path.join(t.templateDir, "package.json");
 			if (await pathExists(templatePkgPath)) {
@@ -156,8 +161,8 @@ const generateProject = async (opts) => {
 				let content = await fs.readFile(file, "utf8");
 				content = processContent(relativePath, content, opts, addedDeps);
 				let finalTargetPath = targetPath;
-				if (type === "webpage" && skipBuild && relativePath === "src/index.ts") {
-					debug("Changing target path for webpage index.ts to .js due to skipBuild");
+				if (type === "web-vanilla" && skipBuild && relativePath === "src/index.ts") {
+					debug("Changing target path for web-vanilla index.ts to .js due to skipBuild");
 					finalTargetPath = path.join(projectDir, "src/index.js");
 				}
 				if (isUpdate && await pathExists(finalTargetPath)) {
@@ -209,37 +214,51 @@ const generateProject = async (opts) => {
 		const workspaceYaml = `packages:\n${finalPkg.workspaces.map((w) => `  - '${w}'`).join("\n")}\n`;
 		await fs.writeFile(path.join(projectDir, "pnpm-workspace.yaml"), workspaceYaml);
 		delete finalPkg.workspaces;
-		for (const [key, value] of Object.entries(finalPkg.scripts)) if (typeof value === "string" && value.includes("--workspaces")) finalPkg.scripts[key] = value.replace("run ", "-r run ").replace(" --workspaces", "");
+		for (const key of Object.keys(finalPkg.scripts)) {
+			const value = finalPkg.scripts[key];
+			if (typeof value === "string" && value.includes("--workspaces")) finalPkg.scripts[key] = value.replace(" run ", " -r run ").replace(" --workspaces", "");
+		}
 	}
 	if (skipBuild) {
 		debug("Applying skipBuild overrides");
 		delete finalPkg.scripts.build;
 		delete finalPkg.scripts.dev;
-		if (finalPkg.devDependencies) delete finalPkg.devDependencies.tsdown;
+		if (finalPkg.devDependencies) {
+			delete finalPkg.devDependencies.tsdown;
+			delete finalPkg.devDependencies.vite;
+			delete finalPkg.devDependencies["@vitejs/plugin-react"];
+		}
 		if (finalPkg.scripts.ci) finalPkg.scripts.ci = finalPkg.scripts.ci.replace(" && npm run build", "").replace(` && ${pm} run build`, "");
-		debug("Removing tsdown configs due to skipBuild");
+		debug("Removing build tool configs due to skipBuild");
 		await fs.rm(path.join(projectDir, "tsdown.config.ts"), { force: true });
-		await fs.rm(path.join(projectDir, "client/tsdown.config.ts"), { force: true });
-		await fs.rm(path.join(projectDir, "server/tsdown.config.ts"), { force: true });
+		await fs.rm(path.join(projectDir, "vite.config.ts"), { force: true });
+		await fs.rm(path.join(projectDir, "vite.config.server.ts"), { force: true });
+		await fs.rm(path.join(projectDir, "client/vite.config.ts"), { force: true });
+		await fs.rm(path.join(projectDir, "server/vite.config.ts"), { force: true });
 	}
 	debug("Writing final consolidated package.json to: %s", pkgPath);
 	await fs.writeFile(pkgPath, JSON.stringify(finalPkg, null, "	"));
+	const stdio = debug.enabled ? "inherit" : "pipe";
 	if (!await pathExists(path.join(projectDir, ".git"))) {
 		debug("Initializing Git repository");
 		try {
+			debug("Executing: git init");
 			await execa("git", ["init"], {
 				cwd: projectDir,
+				stdio,
 				preferLocal: true
 			});
 			log.success("Initialized Git repository (git init).");
 		} catch (e) {
 			debug("Failed to initialize Git: %O", e);
-			log.error("Failed to initialize Git: " + e);
+			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
+			log.error(`Failed to initialize Git: ${e.message}${detail}`);
 		}
 	}
 	if (opts.createGithubRepository && !isUpdate) {
 		debug("Creating GitHub repository");
 		try {
+			debug("Executing: gh repo create %s --public --source=. --remote=origin", projectName);
 			await execa("gh", [
 				"repo",
 				"create",
@@ -249,12 +268,14 @@ const generateProject = async (opts) => {
 				"--remote=origin"
 			], {
 				cwd: projectDir,
+				stdio,
 				preferLocal: true
 			});
 			log.success("Created GitHub repository (gh repo create).");
 		} catch (e) {
 			debug("Failed to create GitHub repository: %O", e);
-			log.warn("Failed to create GitHub repository. Ensure \"gh\" CLI is installed and authenticated.");
+			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.`);
 		}
 	}
 	if (opts.installDependencies) {
@@ -262,16 +283,19 @@ const generateProject = async (opts) => {
 		const s = spinner();
 		s.start(`Installing dependencies using ${pm}...`);
 		try {
+			debug("Executing: %s install", pm);
 			await execa(pm, ["install"], {
 				cwd: projectDir,
+				stdio,
 				preferLocal: true
 			});
 			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Dependencies installed (${pm} install).`);
 		} catch (e) {
 			debug("Failed to install dependencies: %O", e);
 			s.stop("Failed to install dependencies.");
-			log.error(String(e));
-			throw new Error("Failed to install dependencies.");
+			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
+			log.error(`${e.message}${detail}`);
+			throw new Error(`Failed to install dependencies: ${e.message}${detail}`);
 		}
 	}
 	if (opts.build && finalPkg.scripts.ci) {
@@ -280,35 +304,43 @@ const generateProject = async (opts) => {
 		if (finalPkg.scripts["prettier-write"]) {
 			s.start(`Formatting files with Prettier (${pm} run prettier-write)...`);
 			try {
+				debug("Executing: %s run prettier-write", pm);
 				await execa(pm, ["run", "prettier-write"], {
 					cwd: projectDir,
+					stdio,
 					preferLocal: true
 				});
 				s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  Files formatted (${pm} run prettier-write).`);
 			} catch (e) {
 				debug("Failed to format files: %O", e);
 				s.stop("Failed to format files.");
+				const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
+				log.error(`${e.message}${detail}`);
 			}
 		}
 		s.start(`Running CI script (lint, build, test) (${pm} run ci)...`);
 		try {
+			debug("Executing: %s run ci", pm);
 			await execa(pm, ["run", "ci"], {
 				cwd: projectDir,
+				stdio,
 				preferLocal: true
 			});
 			s.stop(`\x1b[1G\x1b[2K\x1b[32m◆\x1b[39m  CI script completed (${pm} run ci).`);
 		} catch (e) {
 			debug("Failed to run CI script: %O", e);
 			s.stop("Failed to run CI script.");
-			log.error(String(e));
-			throw new Error("Failed to run CI script.");
+			const detail = e.stdout || e.stderr ? `\n\nOutput:\n${e.stdout}\n${e.stderr}` : "";
+			log.error(`${e.message}${detail}`);
+			throw new Error(`Failed to run CI script: ${e.message}${detail}`);
 		}
 	}
-	log.info(`Project "${projectName}" ${isUpdate ? "updated" : "scaffolded"} successfully in ${projectDir}`);
+	log.success(`Project "${projectName}" ${isUpdate ? "updated" : "scaffolded"} successfully in ${projectDir}`);
 	showSummary(opts, pm, isSilent);
 	if (opts.dev && finalPkg.scripts.dev) {
 		log.info("Starting dev server...");
 		if (opts.open) try {
+			debug("Executing: %s run dev -- --open", pm);
 			await execa(pm, [
 				"run",
 				"dev",
@@ -323,6 +355,7 @@ const generateProject = async (opts) => {
 			log.error("Dev server failed: " + e);
 		}
 		else try {
+			debug("Executing: %s run dev", pm);
 			await execa(pm, ["run", "dev"], {
 				cwd: projectDir,
 				stdio: "inherit",