create-template-project 0.1.0

package/dist/templates/webpage/files/package.json

@@ -0,0 +1,8 @@
+{
+	"devDependencies": {
+		"tsdown": ""
+	},
+	"scripts": {
+		"build": "tsdown"
+	}
+}

package/dist/templates/webpage/files/src/index.test.ts

@@ -0,0 +1,5 @@
+import {expect, test} from 'vitest';
+
+test('math works', () => {
+	expect(1 + 1).toBe(2);
+});

package/dist/templates/webpage/files/src/index.ts

@@ -0,0 +1 @@
+console.log('Hello from Browser Template!');

package/dist/templates/webpage/index.mjs

@@ -0,0 +1,16 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/templates/webpage/index.ts
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const getWebpageTemplate = (_opts) => {
+	return {
+		name: "webpage",
+		dependencies: {},
+		devDependencies: {},
+		scripts: {},
+		files: [],
+		templateDir: path.resolve(__dirname, "files")
+	};
+};
+//#endregion
+export { getWebpageTemplate };

package/dist/types.mjs

@@ -0,0 +1,30 @@
+import { z } from "zod";
+//#region src/types.ts
+const TemplateTypeSchema = z.enum([
+	"cli",
+	"webpage",
+	"webapp",
+	"fullstack"
+]);
+const PackageManagerSchema = z.enum([
+	"npm",
+	"pnpm",
+	"yarn"
+]);
+const ProjectOptionsSchema = z.object({
+	template: TemplateTypeSchema,
+	projectName: z.string().min(1, "Project name is required"),
+	packageManager: PackageManagerSchema.optional().default("npm"),
+	createGithubRepository: z.boolean().optional().default(false),
+	directory: z.string(),
+	overwrite: z.boolean().optional().default(false),
+	update: z.boolean().optional().default(false),
+	skipBuild: z.boolean().optional().default(false),
+	installDependencies: z.boolean().optional().default(false),
+	build: z.boolean().optional().default(false),
+	dev: z.boolean().optional().default(false),
+	open: z.boolean().optional().default(false),
+	silent: z.boolean().optional().default(false)
+});
+//#endregion
+export { ProjectOptionsSchema };

package/dist/utils/file.mjs

@@ -0,0 +1,101 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import debugLib from "debug";
+import { execa } from "execa";
+//#region src/utils/file.ts
+const debug = debugLib("create-template-project:utils:file");
+async function getAllFiles(dirPath, arrayOfFiles = []) {
+	const files = await fs.readdir(dirPath);
+	for (const file of files) 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) {
+	const { projectName, template } = opts;
+	let description = "";
+	switch (template) {
+		case "cli":
+			description = "A modern Node.js CLI application with TypeScript and automated tooling.";
+			break;
+		case "webpage":
+			description = "A standalone web page/application for modern browsers.";
+			break;
+		case "fullstack":
+			description = "A full-stack monorepo with an Express server and a React/MUI client.";
+			break;
+		case "webapp":
+			description = "A classic web application with an Express backend.";
+			break;
+	}
+	let processed = content.replaceAll("{{projectName}}", projectName).replaceAll("{{description}}", description);
+	if (template === "webpage" && filePath === "index.html") processed = processed.replace("{{scriptSrc}}", opts.skipBuild ? "./src/index.js" : "./dist/index.js");
+	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 === "fullstack" && filePath === "tsconfig.json") {
+		processed = processed.replace(/"lib":\s*\["ESNext"\]/, "\"lib\": [\"ESNext\", \"DOM\"]");
+		processed = processed.replace(/"module":\s*"NodeNext"/, "\"module\": \"NodeNext\",\n		\"jsx\": \"react-jsx\"");
+		processed = processed.replace(/"include":\s*\[\s*"src\/\*\*\/\*"\s*\]/, "\"include\": [\"client/src/**/*\", \"server/src/**/*\"]");
+	}
+	return processed;
+}
+function mergePackageJson(target, source) {
+	if (source.scripts) target.scripts = {
+		...target.scripts,
+		...source.scripts
+	};
+	if (source.dependencies) target.dependencies = {
+		...target.dependencies,
+		...source.dependencies
+	};
+	if (source.devDependencies) target.devDependencies = {
+		...target.devDependencies,
+		...source.devDependencies
+	};
+	if (source.workspaces) target.workspaces = source.workspaces;
+}
+function isSeedFile(filePath) {
+	return [
+		"src/",
+		"client/src/",
+		"server/src/",
+		"backend/src/",
+		"frontend/src/"
+	].some((dir) => filePath.startsWith(dir)) || [
+		"index.html",
+		"App.tsx",
+		"main.tsx"
+	].some((file) => filePath === file);
+}
+async function mergeFile(filePath, existing, template, log) {
+	debug("Merging file: %s", filePath);
+	const tempBase = filePath + ".base.tmp";
+	const tempNew = filePath + ".new.tmp";
+	try {
+		await fs.writeFile(tempNew, template);
+		await fs.writeFile(tempBase, "");
+		try {
+			await execa("git", [
+				"merge-file",
+				filePath,
+				tempBase,
+				tempNew
+			], { preferLocal: true });
+			return (await fs.readFile(filePath, "utf8")).trim() !== template.trim() ? "merged" : "updated";
+		} catch (e) {
+			if (e.exitCode === 1) return "conflict";
+			else {
+				debug("Git merge-file failed: %O", e);
+				log.error(`Failed to merge ${filePath}: ${e.message}`);
+				return "error";
+			}
+		}
+	} finally {
+		await fs.rm(tempBase, { force: true });
+		await fs.rm(tempNew, { force: true });
+	}
+}
+//#endregion
+export { getAllFiles, isSeedFile, mergeFile, mergePackageJson, processContent };

package/package.json

@@ -0,0 +1,79 @@
+{
+	"name": "create-template-project",
+	"version": "0.1.0",
+	"type": "module",
+	"license": "MIT",
+	"author": "Dieter Oberkofler",
+	"files": [
+		"dist"
+	],
+	"keywords": [
+		"scaffold",
+		"template",
+		"cli",
+		"typescript"
+	],
+	"bin": {
+		"create-template-project": "./dist/index.mjs"
+	},
+	"scripts": {
+		"run-interactive": "node dist/index.mjs interactive",
+		"run-create-cli": "node dist/index.mjs create --name=my-cli --directory=./temp --template=cli --overwrite --package-manager=pnpm --build",
+		"run-create-webpage": "node dist/index.mjs create --name=my-webpage --directory=./temp --template=webpage --package-manager=pnpm --overwrite --build",
+		"run-create-webapp": "node dist/index.mjs create --name=my-webapp --directory=./temp --template=webapp --package-manager=pnpm --overwrite --build",
+		"run-create-fullstack": "node dist/index.mjs create --name=my-fullstack --directory=./temp --template=fullstack --package-manager=pnpm --overwrite --build",
+		"run-create-all": "npm run run-create-cli && npm run run-create-webpage && npm run run-create-webapp && npm run run-create-fullstack",
+		"build": "tsdown && node scripts/copy-templates.ts",
+		"dependencies-check": "node scripts/dependencies.ts",
+		"dependencies-update": "node scripts/dependencies.ts --update",
+		"lint": "tsc && oxlint --ignore-pattern \"src/templates/**/files\" && npm run prettier",
+		"prettier": "prettier --check .",
+		"prettier-write": "prettier --write .",
+		"test": "vitest run --coverage --exclude '**/*.integration.test.ts'",
+		"test:integration": "vitest run src/generators/project.integration.test.ts --fileParallelism=false --testTimeout=600000",
+		"ci": "npm run lint && npm run build && npm run test",
+		"create-changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
+		"prepare": "husky"
+	},
+	"main": "./dist/index.mjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": "./dist/index.mjs",
+		"./package.json": "./package.json"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git://github.com/doberkofler/create-template-project.git"
+	},
+	"homepage": "https://github.com/doberkofler/create-template-project#readme",
+	"devDependencies": {
+		"@commitlint/cli": "20.4.4",
+		"@commitlint/config-conventional": "20.4.4",
+		"@types/cli-progress": "3.11.6",
+		"@types/debug": "4.1.12",
+		"@types/node": "25.5.0",
+		"@vitest/coverage-v8": "4.1.0",
+		"conventional-changelog": "^7.2.0",
+		"conventional-changelog-angular": "8.3.0",
+		"eslint-plugin-regexp": "3.1.0",
+		"husky": "9.1.7",
+		"oxlint": "1.55.0",
+		"oxlint-tsgolint": "0.16.0",
+		"pnpm": "^10.32.1",
+		"prettier": "3.8.1",
+		"tsdown": "0.21.2",
+		"typescript": "5.9.3",
+		"vitest": "4.1.0"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.1.0",
+		"commander": "14.0.3",
+		"debug": "4.4.3",
+		"execa": "^9.6.1",
+		"zod": "4.3.6"
+	}
+}