create-template-project 0.4.0 → 1.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025- Dieter Oberkofler
+Copyright (c) 2026 Dieter Oberkofler
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,16 +2,30 @@
 
 [![NPM Version](https://img.shields.io/npm/v/create-template-project.svg)](https://www.npmjs.com/package/create-template-project)
 [![NPM Downloads](https://img.shields.io/npm/dm/create-template-project.svg)](https://www.npmjs.com/package/create-template-project)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![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)
+[![Coverage Status](https://coveralls.io/repos/github/doberkofler/create-template-project/badge.svg?branch=main)](https://coveralls.io/github/doberkofler/create-template-project?branch=main)
 
 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
+## 🚀 Quick Start
 
-- **Modern Tech Stack:** All templates come with `commitlint`, `husky`, `vitest`, `oxlint`, `prettier`, and `typescript` (strict mode).
+Run directly without installation:
+
+```bash
+npx create-template-project interactive
+# or
+pnpm dlx create-template-project interactive
+```
+
+## ✨ Features
+
+- **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`.
+- **🔄 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.
@@ -19,12 +33,16 @@ An ultra-modular, type-safe Node.js CLI tool used to scaffold new project templa
 ## Installation
 
 ```bash
+pnpm add -g create-template-project
+# or
 npm install -g create-template-project
 ```
 
-Or run directly using npx:
+Or run directly using pnpm dlx or npx:
 
 ```bash
+pnpm dlx create-template-project
+# or
 npx create-template-project
 ```
 
@@ -47,43 +65,70 @@ You can skip the wizard by using the `create` or `update` commands with the appr
 #### Create a new project
 
 ```bash
-create-template-project create --template cli --name my-cool-tool --github
+create-template-project create --template cli --name my-cool-tool --path ./my-cool-tool --github
 ```
 
 #### Update an existing project
 
 ```bash
-create-template-project update --template cli --name existing-project
+create-template-project update --template cli
 ```
 
 #### Global Options:
 
+- `--debug`: Enable debug output
 - `-h, --help`: Show help
 - `-V, --version`: Show version
 
-#### Command Options (create/update):
+#### Command Options (create):
 
 - `-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)
+- `--description <description>`: Project description
+- `-k, --keywords <keywords>`: Project keywords (comma separated)
+- `-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)
+- `--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
+
+#### Command Options (update):
+
+- `-t, --template <type>`: Template type (`cli`, `web-vanilla`, `web-app`, `web-fullstack`)
+- `--description <description>`: Project description
+- `-k, --keywords <keywords>`: Project keywords (comma separated)
+- `-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)
 - `-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 `web-app`)
-- `--no-progress`: Do not show progress indicators (useful for AI environments)
+- `--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
+- `--no-progress`: Do not show progress indicators
 
 ## Project Templates
 
 ### 🟢 CLI
+
 A clean Node.js CLI environment featuring `commander` and `cli-progress`. Supports optional Vite bundling.
 
 ### 🔵 Web-Vanilla
+
 Standalone web page setup for modern browsers. Can be used with or without a build step.
 
 ### 🟡 Web-App
+
 Modern React application featuring MUI components and TanStack Query for state management.
 
 ### ⚛️ Web-Fullstack
+
 A full-stack monorepo featuring:
+
 - **Client**: React with MUI (including Icons) and TypeScript.
 - **Server**: Express.js backend with tRPC for end-to-end type safety.
 - **E2E**: Playwright for end-to-end testing.

package/dist/config/dependencies.json

@@ -1,7 +1,7 @@
 {
 	"dependencies": {
 		"vite": {
-			"version": "8.0.1",
+			"version": "8.0.2",
 			"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.0",
+			"version": "4.1.1",
 			"description": "Run Vitest in the browser."
 		},
 		"@vitest/browser-playwright": {
-			"version": "4.1.0",
+			"version": "4.1.1",
 			"description": "Playwright provider for Vitest browser mode."
 		},
 		"playwright": {
@@ -41,7 +41,7 @@
 			"description": "TypeScript definitions for Node.js."
 		},
 		"@vitest/coverage-v8": {
-			"version": "4.1.0",
+			"version": "4.1.1",
 			"description": "V8 coverage provider for Vitest."
 		},
 		"conventional-changelog": {
@@ -60,16 +60,16 @@
 			"version": "0.17.1",
 			"description": "TypeScript-specific rules for oxlint."
 		},
-		"prettier": {
-			"version": "3.8.1",
-			"description": "An opinionated code formatter."
+		"oxfmt": {
+			"version": "0.41.0",
+			"description": "High performance JavaScript / TypeScript formatter."
 		},
 		"typescript": {
 			"version": "5.9.3",
 			"description": "A superset of JavaScript that compiles to clean JavaScript output."
 		},
 		"vitest": {
-			"version": "4.1.0",
+			"version": "4.1.1",
 			"description": "A Vite-native unit test framework."
 		},
 		"commander": {
@@ -129,19 +129,19 @@
 			"description": "End-to-end testing framework."
 		},
 		"@trpc/server": {
-			"version": "11.14.1",
+			"version": "11.15.0",
 			"description": "tRPC server library."
 		},
 		"@trpc/client": {
-			"version": "11.14.1",
+			"version": "11.15.0",
 			"description": "tRPC client library."
 		},
 		"@trpc/react-query": {
-			"version": "11.14.1",
+			"version": "11.15.0",
 			"description": "tRPC integration for React Query."
 		},
 		"@tanstack/react-query": {
-			"version": "5.94.5",
+			"version": "5.95.2",
 			"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.13.1",
+			"version": "7.13.2",
 			"description": "Declarative routing for React web applications."
 		},
 		"cors": {