create-template-project 1.1.3 → 1.2.0

package/README.md

@@ -132,6 +132,16 @@ A full-stack monorepo featuring:
 - **Server**: Express.js backend with tRPC for end-to-end type safety.
 - **E2E**: Playwright for end-to-end testing.
 
+## Release Process
+
+To cut a new release and automatically create a GitHub Release securely:
+
+```bash
+GITHUB_TOKEN=$(gh auth token) pnpm release -- patch # minor, or major
+```
+
+For more details on the release flow, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## Contributing
 
 Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this project.

package/dist/config/dependencies.json

@@ -1,7 +1,7 @@
 {
 	"dependencies": {
 		"vite": {
-			"version": "8.0.5",
+			"version": "8.0.8",
 			"description": "Native-ESM powered web dev build tool"
 		},
 		"@vitejs/plugin-react": {
@@ -9,11 +9,11 @@
 			"description": "The default Vite plugin for React projects."
 		},
 		"@vitest/browser": {
-			"version": "4.1.2",
+			"version": "4.1.4",
 			"description": "Run Vitest in the browser."
 		},
 		"@vitest/browser-playwright": {
-			"version": "4.1.2",
+			"version": "4.1.4",
 			"description": "Playwright provider for Vitest browser mode."
 		},
 		"playwright": {
@@ -37,11 +37,11 @@
 			"description": "TypeScript definitions for debug."
 		},
 		"@types/node": {
-			"version": "25.5.2",
+			"version": "25.6.0",
 			"description": "TypeScript definitions for Node.js."
 		},
 		"@vitest/coverage-v8": {
-			"version": "4.1.2",
+			"version": "4.1.4",
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
@@ -53,7 +53,7 @@
 			"description": "Modern native git hooks made easy."
 		},
 		"oxlint": {
-			"version": "1.58.0",
+			"version": "1.60.0",
 			"description": "A JavaScript linter written in Rust."
 		},
 		"oxlint-tsgolint": {
@@ -61,7 +61,7 @@
 			"description": "TypeScript-specific rules for oxlint."
 		},
 		"oxfmt": {
-			"version": "0.43.0",
+			"version": "0.45.0",
 			"description": "High performance JavaScript / TypeScript formatter."
 		},
 		"typescript": {
@@ -69,7 +69,7 @@
 			"description": "A superset of JavaScript that compiles to clean JavaScript output."
 		},
 		"vitest": {
-			"version": "4.1.2",
+			"version": "4.1.4",
 			"description": "A Vite-native unit test framework."
 		},
 		"commander": {
@@ -93,19 +93,19 @@
 			"description": "TypeScript definitions for Express."
 		},
 		"react": {
-			"version": "19.2.4",
+			"version": "19.2.5",
 			"description": "A JavaScript library for building user interfaces."
 		},
 		"react-dom": {
-			"version": "19.2.4",
+			"version": "19.2.5",
 			"description": "React package for working with the DOM."
 		},
 		"@mui/material": {
-			"version": "7.3.9",
+			"version": "9.0.0",
 			"description": "Material UI components."
 		},
 		"@mui/icons-material": {
-			"version": "7.3.9",
+			"version": "9.0.0",
 			"description": "Material Design icons distributed as SVG React components."
 		},
 		"@emotion/react": {
@@ -141,7 +141,7 @@
 			"description": "tRPC integration for React Query."
 		},
 		"@tanstack/react-query": {
-			"version": "5.96.2",
+			"version": "5.99.0",
 			"description": "Powerful asynchronous state management for TS/JS."
 		},
 		"zod": {
@@ -149,7 +149,7 @@
 			"description": "TypeScript-first schema validation with static type inference."
 		},
 		"react-router-dom": {
-			"version": "7.14.0",
+			"version": "7.14.1",
 			"description": "Declarative routing for React web applications."
 		},
 		"release-it": {

package/dist/index.js

@@ -7,7 +7,6 @@ import { execa } from "execa";
 import path from "node:path";
 import fs from "node:fs/promises";
 import debugLib from "debug";
-import { fileURLToPath } from "node:url";
 import { existsSync } from "node:fs";
 //#region src/shared/types.ts
 var TemplateTypeSchema = z.enum([
@@ -56,10 +55,7 @@ var genericProcessor = (content, { opts }) => {
 		default: break;
 	}
 	const pm = opts.packageManager;
-	let lockfileRules = "";
-	if (pm === "pnpm") lockfileRules = "package-lock.json\nyarn.lock";
-	else if (pm === "yarn") lockfileRules = "package-lock.json\npnpm-lock.yaml";
-	else lockfileRules = "yarn.lock\npnpm-lock.yaml";
+	const lockfileRules = pm === "pnpm" ? "package-lock.json\nyarn.lock" : pm === "yarn" ? "package-lock.json\npnpm-lock.yaml" : "yarn.lock\npnpm-lock.yaml";
 	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
@@ -260,7 +256,6 @@ var mergeFile = async (filePath, existing, template, log) => {
 };
 //#endregion
 //#region src/templates/base/index.ts
-var __dirname$5 = path.dirname(fileURLToPath(import.meta.url));
 var getBaseTemplate = (_opts) => ({
 	name: "base",
 	description: "The foundation for all project templates, including common tooling and configuration.",
@@ -313,11 +308,10 @@ var getBaseTemplate = (_opts) => ({
 	},
 	scripts: {},
 	files: [],
-	templateDir: getTemplateDir(__dirname$5, "base")
+	templateDir: getTemplateDir(import.meta.dirname, "base")
 });
 //#endregion
 //#region src/templates/cli/index.ts
-var __dirname$4 = path.dirname(fileURLToPath(import.meta.url));
 var getCliTemplate = (_opts) => {
 	return {
 		name: "cli",
@@ -340,12 +334,11 @@ var getCliTemplate = (_opts) => {
 		devDependencies: { vite: "vite" },
 		scripts: {},
 		files: [],
-		templateDir: getTemplateDir(__dirname$4, "cli")
+		templateDir: getTemplateDir(import.meta.dirname, "cli")
 	};
 };
 //#endregion
 //#region src/templates/web-vanilla/index.ts
-var __dirname$3 = path.dirname(fileURLToPath(import.meta.url));
 var getWebVanillaTemplate = (_opts) => ({
 	name: "web-vanilla",
 	description: "A modern, standalone web page template with built-in development and testing tooling.",
@@ -381,11 +374,10 @@ var getWebVanillaTemplate = (_opts) => ({
 		"integration-test": "playwright test"
 	},
 	files: [],
-	templateDir: getTemplateDir(__dirname$3, "web-vanilla")
+	templateDir: getTemplateDir(import.meta.dirname, "web-vanilla")
 });
 //#endregion
 //#region src/templates/web-app/index.ts
-var __dirname$2 = path.dirname(fileURLToPath(import.meta.url));
 var getWebAppTemplate = (_opts) => ({
 	name: "web-app",
 	description: "A React application with MUI and TanStack Query, powered by Vite.",
@@ -446,11 +438,10 @@ var getWebAppTemplate = (_opts) => ({
 		start: "vite preview"
 	},
 	files: [],
-	templateDir: getTemplateDir(__dirname$2, "web-app")
+	templateDir: getTemplateDir(import.meta.dirname, "web-app")
 });
 //#endregion
 //#region src/templates/web-fullstack/index.ts
-var __dirname$1 = path.dirname(fileURLToPath(import.meta.url));
 var getWebFullstackTemplate = (_opts) => ({
 	name: "web-fullstack",
 	description: "A comprehensive full-stack monorepo featuring an Express backend with tRPC and a modern React client with MUI.",
@@ -520,7 +511,7 @@ var getWebFullstackTemplate = (_opts) => ({
 		"integration-test": "playwright test"
 	},
 	files: [],
-	templateDir: getTemplateDir(__dirname$1, "web-fullstack")
+	templateDir: getTemplateDir(import.meta.dirname, "web-fullstack")
 });
 //#endregion
 //#region src/templates/registry.ts
@@ -1034,7 +1025,7 @@ Restrictions & Behavior:
 //#endregion
 //#region src/generators/project.ts
 var debug$1 = debugLib("create-template-project:generator");
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var moduleDir = import.meta.dirname;
 var pathExists = async (filePath) => {
 	try {
 		await fs.access(filePath);
@@ -1044,8 +1035,8 @@ var pathExists = async (filePath) => {
 	}
 };
 var getDependencyConfigPath = async () => {
-	const sourcePath = path.resolve(__dirname, "../config/dependencies.json");
-	const distPath = path.resolve(__dirname, "config/dependencies.json");
+	const sourcePath = path.resolve(moduleDir, "../config/dependencies.json");
+	const distPath = path.resolve(moduleDir, "config/dependencies.json");
 	return await pathExists(distPath) ? distPath : sourcePath;
 };
 var getLog = (progress) => ({
@@ -1604,6 +1595,11 @@ var generateProject = async (opts) => {
 };
 generateGeneratedMd = async (projectDir, opts, pm, states, isUpdate, status, actions) => {
 	const statusBadge = status.hasErrors ? "🔴 **Completed with Errors**" : status.hasWarnings ? "🟡 **Completed with Warnings**" : "🟢 **Successfully Completed**";
+	const skippedStepInstructions = [
+		...states.depsSkipped ? [`- [ ] **Install dependencies manually:** Run \`${pm} install\` from the project root.`] : [],
+		...states.githubSkipped ? [`- [ ] **Create and push GitHub repository manually:** Verify GitHub CLI auth with \`gh auth status\`, then run \`gh repo create ${opts.projectName} --public --source=. --remote=origin --push\`.`] : [],
+		...states.ciSkipped ? [`- [ ] **Run CI checks manually:** After dependencies are installed, run \`${pm} run ci\`.`] : []
+	];
 	const md = [
 		`# 🚀 Project Setup Guide: ${opts.projectName}`,
 		"",
@@ -1632,6 +1628,12 @@ generateGeneratedMd = async (projectDir, opts, pm, states, isUpdate, status, act
 		`- [${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)*" : ""}`,
 		"",
+		...skippedStepInstructions.length > 0 ? [
+			"## ⏭️ Complete Skipped Steps Manually",
+			"Some initialization steps were marked as *(Skipped)*. Use the guidance below to complete them yourself:",
+			...skippedStepInstructions,
+			""
+		] : [],
 		...isUpdate ? [
 			"### 🛠️ Upgrade Details",
 			"The following files were affected by this update:",
@@ -1722,6 +1724,7 @@ generateGeneratedMd = async (projectDir, opts, pm, states, isUpdate, status, act
 		"| Command | Description |",
 		"| :--- | :--- |",
 		"| `gh repo view --web` | Open the repository in your default web browser |",
+		"| `gh repo create <name> --public --source=. --remote=origin --push` | Create and push a new GitHub repository |",
 		"| `gh pr create` | Create a new Pull Request |",
 		"| `gh pr checkout <pr-number>` | Checkout a Pull Request branch locally |",
 		"| `gh issue create` | Create a new Issue |",

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

@@ -5,7 +5,7 @@
 	"git": {
 		"requireCleanWorkingDir": true,
 		"commit": true,
-		"commitMessage": "chore(release): ${version}",
+		"commitMessage": "chore: release ${version}",
 		"tag": true,
 		"tagName": "v${version}",
 		"push": true,

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

@@ -149,6 +149,7 @@ export const linter = defineConfig({
 		'unicorn/no-array-reduce': 'off', // TODO: consider enabling
 		'unicorn/no-array-sort': 'off', // TODO: consider enabling
 		'unicorn/no-hex-escape': 'off',
+		'unicorn/no-immediate-mutation': 'off',
 		'unicorn/no-nested-ternary': 'off',
 		'unicorn/no-null': 'off', // TODO: consider enabling
 		'unicorn/no-process-exit': 'off', // TODO: consider enabling
@@ -161,6 +162,14 @@ export const linter = defineConfig({
 		'vitest/prefer-to-be-truthy': 'off', // FIXME: Conflict Detected: prefer-strict-boolean-matchers enforces toBe(true), but prefer-to-be-truthy enforces toBeTruthy().
 		'vitest/require-test-timeout': 'off',
 	},
+	overrides: [
+		{
+			files: ['tests/e2e/**/*.e2e-test.ts', '**/*.e2e-test.ts'],
+			rules: {
+				'vitest/prefer-importing-vitest-globals': 'off',
+			},
+		},
+	],
 	settings: {
 		'jsx-a11y': {
 			polymorphicPropName: undefined,

package/dist/templates/web-fullstack/files/client/src/App.tsx

@@ -1,5 +1,5 @@
 /* eslint-disable react/jsx-max-depth */
-import {useState, type ReactNode} from 'react';
+import {useMemo, type ReactNode} from 'react';
 import {BrowserRouter, Routes, Route, Navigate} from 'react-router-dom';
 import {QueryClient, QueryClientProvider} from '@tanstack/react-query';
 import {httpBatchLink} from '@trpc/client';
@@ -13,8 +13,9 @@ import {CssBaseline, ThemeProvider, createTheme} from '@mui/material';
 const theme = createTheme();
 
 export const App = (): ReactNode => {
-	const [queryClient] = useState(() => new QueryClient());
-	const [trpcClient] = useState(() =>
+	const queryClient = useMemo(() => new QueryClient(), []);
+	const trpcClient = useMemo(
+		() =>
 		trpc.createClient({
 			links: [
 				httpBatchLink({
@@ -26,6 +27,7 @@ export const App = (): ReactNode => {
 				}),
 			],
 		}),
+		[],
 	);
 
 	return (

package/dist/templates/web-fullstack/files/client/src/components/ProtectedRoute.tsx

@@ -9,7 +9,7 @@ export const ProtectedRoute = (): ReactNode => {
 
 	if (isLoading) {
 		return (
-			<Box display="flex" justifyContent="center" alignItems="center" minHeight="100vh">
+			<Box sx={{display: 'flex', justifyContent: 'center', alignItems: 'center', minHeight: '100vh'}}>
 				<CircularProgress />
 			</Box>
 		);

package/dist/templates/web-fullstack/files/client/src/pages/Dashboard.tsx

@@ -18,9 +18,9 @@ export const Dashboard = (): ReactNode => {
 
 	return (
 		<Container maxWidth="md">
-			<Box mt={4}>
+			<Box sx={{mt: 4}}>
 				<Paper elevation={3}>
-					<Box p={4}>
+					<Box sx={{p: 4}}>
 						<Typography variant="h4" gutterBottom>
 							Dashboard
 						</Typography>
@@ -28,7 +28,7 @@ export const Dashboard = (): ReactNode => {
 						<Typography variant="body1" color="textSecondary" gutterBottom>
 							Email: {user?.email ?? ''}
 						</Typography>
-						<Box mt={4}>
+						<Box sx={{mt: 4}}>
 							<Typography variant="body2" gutterBottom>
 								This is a protected page. You can only see this because you are logged in.
 							</Typography>

package/dist/templates/web-fullstack/files/client/src/pages/Login.tsx

@@ -36,7 +36,7 @@ export const Login = (): ReactNode => {
 			<form onSubmit={handleSubmit}>
 				<DialogTitle>Login</DialogTitle>
 				<DialogContent>
-					<Box display="flex" flexDirection="column" gap={2} pt={1}>
+					<Box sx={{display: 'flex', flexDirection: 'column', gap: 2, pt: 1}}>
 						{error !== null && <Alert severity="error">{error}</Alert>}
 						<Typography variant="body2" color="textSecondary">
 							Use <b>demo@example.com</b> / <b>password</b> to login.

package/dist/templates/web-fullstack/files/server/src/index.ts

@@ -4,9 +4,8 @@ import * as trpcExpress from '@trpc/server/adapters/express';
 import {appRouter} from './routers/_app.js';
 import {createContext} from './context.js';
 import path from 'node:path';
-import {fileURLToPath} from 'node:url';
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const __dirname = import.meta.dirname;
 const app = express();
 const port = Number(process.env['PORT'] ?? 3001);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-template-project",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "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": [
@@ -82,21 +82,21 @@
     "@commitlint/config-conventional": "20.5.0",
     "@types/cli-progress": "3.11.6",
     "@types/debug": "4.1.13",
-    "@types/node": "25.5.2",
-    "@vitest/coverage-v8": "4.1.2",
+    "@types/node": "25.6.0",
+    "@vitest/coverage-v8": "4.1.4",
     "conventional-changelog": "7.2.0",
     "conventional-changelog-angular": "8.3.1",
     "eslint-plugin-regexp": "3.1.0",
     "husky": "9.1.7",
-    "oxfmt": "0.43.0",
-    "oxlint": "1.58.0",
+    "oxfmt": "0.45.0",
+    "oxlint": "1.60.0",
     "oxlint-tsgolint": "0.20.0",
     "pnpm": "10.33.0",
     "release-it": "19.2.4",
     "rimraf": "6.1.3",
     "typescript": "6.0.2",
-    "vite": "8.0.5",
-    "vitest": "4.1.2"
+    "vite": "8.0.8",
+    "vitest": "4.1.4"
   },
   "engines": {
     "node": ">=22"