create-koppajs 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -16,6 +16,63 @@ _No unreleased changes yet._
 
 ---
 
+## [1.2.4] — Starter Dotfile Removal
+
+**2026-04-24**
+
+Patch release to remove the last generated dotfile defaults from new apps.
+
+### Removed
+
+- removed generated `.gitattributes`, `.gitignore`, and `.npmrc` files from
+  generated minimal and router starters
+- removed the remaining CLI copy-time dotfile rename behavior because the
+  generated starter no longer ships underscore-prefixed dotfile placeholders
+
+### Changed
+
+- updated pnpm usage examples to `pnpm create koppajs@latest` so users bypass
+  stale pnpm create/dlx cache entries after a new release
+
+---
+
+## [1.2.3] — Lean Starter Maintenance
+
+**2026-04-24**
+
+Patch release to keep generated projects focused on runnable KoppaJS app code.
+This is a maintainer-approved patch exception to the versioning policy because
+the CLI invocation contract stays unchanged while the generated starter tree is
+intentionally reduced.
+
+### Changed
+
+- trimmed generated starters to app source, README, and Vite/TypeScript build
+  files
+- switched generated starter views from the remote KoppaJS logo URL to a local
+  `public/koppajs-logo.png` asset
+- switched generated starter favicon output from `public/favicon.svg` to
+  `public/favicon.png`
+- stopped patching generated `CHANGELOG.md` and `RELEASE.md`; those files are
+  no longer included in new apps
+- refreshed the compatible generated-starter toolchain to `vite@7.3.2` and
+  `@types/node@25.6.0` while keeping `typescript@5.9.3` within the current
+  `@koppajs/koppajs-vite-plugin` peer range
+- raised repository and generated-starter pnpm metadata to `pnpm@10.33.2`,
+  with a declared minimum of `>=10.24.0`
+- raised repository and generated-starter Node.js metadata to `>=22.12.0`
+
+### Removed
+
+- removed governance, ADR/spec docs, GitHub workflows, Husky hooks, commitlint,
+  lint-staged, release files, changelog files, license files, and starter
+  lockfiles from generated projects
+- removed generated-starter lint, format, and test tooling, including ESLint,
+  Prettier, Vitest, Playwright, their configs, scripts, dependencies, and test
+  files
+
+---
+
 ## [1.2.2] — Node & Validation Baseline Alignment
 
 **2026-03-27**

package/README.md

@@ -18,7 +18,7 @@
   <h1 align="center">create-koppajs</h1>
   <h3 align="center">Official project scaffolder for KoppaJS</h3>
   <p align="center">
-    <i>Generate a ready-to-run KoppaJS starter with the current quality baseline in one command.</i>
+    <i>Generate a ready-to-run KoppaJS starter in one command.</i>
   </p>
 </div>
 
@@ -118,9 +118,7 @@ The stable public contract of this repository is:
   target directories
 - recursive copying of the bundled `template/` directory plus any selected
   overlay
-- restoration of publish-safe dotfiles and dotdirectories during copy
-- patching of generated `package.json`, `README.md`, `CHANGELOG.md`, and
-  `RELEASE.md`
+- patching of generated `package.json` and `README.md`
 - the generated starter baselines defined by `template/` and
   `template-overlays/`
 - the npm package payload: `bin/`, `template/`, `template-overlays/`,
@@ -138,13 +136,13 @@ The governing specs for that contract are:
 Default starter:
 
 ```bash
-pnpm create koppajs my-app
+pnpm create koppajs@latest my-app
 ```
 
 Router starter:
 
 ```bash
-pnpm create koppajs my-app --template router
+pnpm create koppajs@latest my-app --template router
 ```
 
 Alternative entrypoints:
@@ -173,8 +171,8 @@ pnpm dev
 
 ## Requirements
 
-- for `create-koppajs`: Node.js `>=22`
-- for generated starter projects: Node.js `>=22` and pnpm `>=10`
+- for `create-koppajs`: Node.js `>=22.12.0` and pnpm `>=10.24.0`
+- for generated starter projects: Node.js `>=22.12.0` and pnpm `>=10.24.0`
 
 ---
 
@@ -189,10 +187,13 @@ The generated project includes one of two supported starters:
 
 Every starter also includes:
 
-- quality tooling through ESLint, Prettier, Vitest, and Playwright
-- local workflow guards through Husky, lint-staged, and commitlint
-- starter governance files, ADR/spec structure, and release-process documents
-- GitHub workflows for CI and tagged releases
+- a focused README with setup, scripts, and project structure
+
+The generated project intentionally excludes repository governance files,
+release automation, GitHub workflows, Git hooks, changelog files, lockfiles,
+default dotfiles, and lint/format/test tooling. Those files belong to this
+scaffolder repository or to project-specific app decisions, not to every new
+application created from it.
 
 The root repository treats those starters as versioned product surface, not
 test data. `template/` plus the supported overlays are the only source of truth

package/bin/create-koppajs.js

@@ -103,7 +103,7 @@ export function printHelp() {
   Scaffold a new KoppaJS project.
 
   Usage:
-    pnpm create koppajs [project-name]
+    pnpm create koppajs@latest [project-name]
     npm create koppajs [project-name]
     npx create-koppajs [project-name]
 
@@ -114,8 +114,8 @@ export function printHelp() {
     --router                  Shortcut for --template router
 
   Example:
-    pnpm create koppajs my-app
-    pnpm create koppajs my-app --template router
+    pnpm create koppajs@latest my-app
+    pnpm create koppajs@latest my-app --template router
 `);
 }
 
@@ -203,17 +203,7 @@ export function ensureTargetDir(targetPath) {
 
 // ── Copy ────────────────────────────────────────────────────────────
 
-// npm excludes .gitignore from published packages — ship as _gitignore
-// and rename during scaffolding (same approach as create-vite).
-const RENAME_FILES = {
-  _editorconfig: ".editorconfig",
-  _gitattributes: ".gitattributes",
-  _github: ".github",
-  _gitignore: ".gitignore",
-  _husky: ".husky",
-  _npmrc: ".npmrc",
-  _prettierignore: ".prettierignore",
-};
+const RENAME_FILES = {};
 
 export function copyDirRecursive(src, dest) {
   mkdirSync(dest, { recursive: true });
@@ -261,14 +251,6 @@ export function patchReadme(destDir, projectName) {
   patchTextFile(destDir, "README.md", projectName);
 }
 
-export function patchChangelog(destDir, projectName) {
-  patchTextFile(destDir, "CHANGELOG.md", projectName);
-}
-
-export function patchReleaseNotes(destDir, projectName) {
-  patchTextFile(destDir, "RELEASE.md", projectName);
-}
-
 // ── Final output ────────────────────────────────────────────────────
 
 export function printNextSteps(projectName) {
@@ -327,8 +309,6 @@ export async function runCli(
   copyStarterTemplate(templateName, targetDir);
   patchPackageJson(targetDir, projectName);
   patchReadme(targetDir, projectName);
-  patchChangelog(targetDir, projectName);
-  patchReleaseNotes(targetDir, projectName);
   printNextSteps(projectName);
 
   return 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-koppajs",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "private": false,
   "type": "module",
   "description": "Scaffold a new KoppaJS project in seconds.",
@@ -15,10 +15,10 @@
     "README.md",
     "LICENSE"
   ],
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.33.2",
   "engines": {
-    "node": ">=22",
-    "pnpm": ">=10"
+    "node": ">=22.12.0",
+    "pnpm": ">=10.24.0"
   },
   "scripts": {
     "check:meta": "node scripts/check-meta-layer.mjs",

package/template/README.md

@@ -1,90 +1,11 @@
-<a id="readme-top"></a>
+# __PROJECT_NAME__
 
-<div align="center">
-  <img src="https://public-assets-1b57ca06-687a-4142-a525-0635f7649a5c.s3.eu-central-1.amazonaws.com/koppajs/koppajs-logo-text-900x226.png" width="500" alt="KoppaJS Logo">
-</div>
-
-<br>
-
-<div align="center">
-  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square" alt="License"></a>
-</div>
-
-<br>
-
-<div align="center">
-  <h1 align="center">__PROJECT_NAME__</h1>
-  <h3 align="center">KoppaJS starter project</h3>
-  <p align="center">
-    <i>Scaffolded from the current official KoppaJS starter baseline.</i>
-  </p>
-</div>
-
-<br>
-
-<div align="center">
-  <p align="center">
-    <a href="https://github.com/koppajs/koppajs-documentation">Documentation</a>
-    &middot;
-    <a href="https://github.com/koppajs/koppajs-core">KoppaJS Core</a>
-    &middot;
-    <a href="https://github.com/koppajs/koppajs-vite-plugin">Vite Plugin</a>
-  </p>
-</div>
-
-<br>
-
-<details>
-<summary>Table of Contents</summary>
-  <ol>
-    <li><a href="#what-is-this">What is this?</a></li>
-    <li><a href="#requirements">Requirements</a></li>
-    <li><a href="#getting-started">Getting Started</a></li>
-    <li><a href="#quality-workflow">Quality Workflow</a></li>
-    <li><a href="#release-workflow">Release Workflow</a></li>
-    <li><a href="#project-structure">Project Structure</a></li>
-    <li><a href="#meta-layer">Meta Layer</a></li>
-    <li><a href="#community--contribution">Community & Contribution</a></li>
-    <li><a href="#license">License</a></li>
-  </ol>
-</details>
-
----
-
-## What is this?
-
-This project was scaffolded from the current official minimal starter baseline
-for KoppaJS.
-
-It keeps the runtime intentionally small:
-
-- one HTML shell
-- one TypeScript bootstrap file
-- one root view
-- one stateful child component
-
-It also carries a small quality baseline so the starter stays runnable and trustworthy:
-
-- ESLint for source and tooling files
-- Prettier plus `.editorconfig` for supported text formats
-- Vitest for local unit and integration coverage
-- Playwright for a real-browser smoke test
-- Husky plus lint-staged for fast staged-file checks
-- Conventional Commits enforcement via `commitlint`
-- a tag-driven GitHub release baseline with `CHANGELOG.md` and `RELEASE.md`
-
-Use it as a starting point for new KoppaJS projects or as a reference for how components are registered, composed, and validated.
-
-> **Note:** This repository uses published npm packages, so it works as a standalone starter after `pnpm install`.
-
----
+KoppaJS starter project scaffolded with `create-koppajs`.
 
 ## Requirements
 
-- Node.js >= 22
-- pnpm >= 10
-
----
+- Node.js >= 22.12.0
+- pnpm >= 10.24.0
 
 ## Getting Started
 
@@ -93,146 +14,35 @@ pnpm install
 pnpm dev
 ```
 
-Install the Playwright browser once if you want to run the browser smoke test locally:
-
-```bash
-pnpm exec playwright install chromium
-```
-
-Useful commands:
+## Scripts
 
 ```bash
-pnpm lint
-pnpm format:check
-pnpm typecheck
-pnpm test:run
-pnpm test:coverage
 pnpm build
+pnpm typecheck
 pnpm serve
-pnpm release:check
-```
-
-Commit messages follow Conventional Commits, for example:
-
-```text
-feat: add release workflow
-docs: update starter governance
-fix: align counter button labels
 ```
 
----
-
-## Quality Workflow
-
-Fast local baseline:
-
-```bash
-pnpm check
-```
-
-Full validation, including Playwright:
-
-```bash
-pnpm validate
-```
-
-Standalone browser smoke test:
-
-```bash
-pnpm test:e2e
-```
-
----
-
-## Release Workflow
-
-Tagged releases are documented in `CHANGELOG.md`.
-The maintainer procedure lives in `RELEASE.md`.
-
-Release tags must use the form `vX.Y.Z` and match `package.json`.
-The included automation creates GitHub Releases only. If your project later
-needs npm publishing or deployment-specific release steps, update `RELEASE.md`
-and `.github/workflows/release.yml` together.
-
----
-
 ## Project Structure
 
 ```text
 __PROJECT_NAME__/
-├── .editorconfig
-├── .github/
-├── .gitignore
-├── .husky/
-├── .npmrc
-├── .prettierignore
-├── CHANGELOG.md
-├── commitlint.config.mjs
-├── AI_CONSTITUTION.md
-├── ARCHITECTURE.md
-├── CONTRIBUTING.md
-├── DECISION_HIERARCHY.md
-├── DEVELOPMENT_RULES.md
-├── RELEASE.md
-├── ROADMAP.md
-├── TESTING_STRATEGY.md
-├── eslint.config.mjs
+├── README.md
 ├── index.html
 ├── package.json
-├── playwright.config.ts
-├── pnpm-lock.yaml
-├── prettier.config.mjs
 ├── tsconfig.json
 ├── vite.config.mjs
-├── vitest.config.mjs
-├── docs/
-│   ├── adr/
-│   ├── architecture/
-│   ├── meta/
-│   ├── quality/
-│   └── specs/
 ├── public/
-│   └── favicon.svg
-├── src/
-│   ├── main.ts
-│   ├── style.css
-│   ├── app-view.kpa
-│   └── counter-component.kpa
-└── tests/
-    ├── e2e/
-    ├── integration/
-    └── unit/
+│   ├── favicon.png
+│   └── koppajs-logo.png
+└── src/
+    ├── app-view.kpa
+    ├── counter-component.kpa
+    ├── main.ts
+    └── style.css
 ```
 
----
-
-## Meta Layer
-
-The repository includes an explicit meta layer so architecture, testing, and contributor rules evolve together with the codebase.
-
-Start here:
-
-- `DECISION_HIERARCHY.md`
-- `AI_CONSTITUTION.md`
-- `ARCHITECTURE.md`
-- `DEVELOPMENT_RULES.md`
-- `TESTING_STRATEGY.md`
-- `CHANGELOG.md`
-- `RELEASE.md`
-- `docs/quality/quality-gates.md`
-- `docs/adr/`
-- `docs/specs/`
-
----
-
-## Community & Contribution
-
-Contribution workflow details live in `CONTRIBUTING.md`.
-Update this section with your own repository links once the project has a
-canonical home.
-
----
-
-## License
+## Useful Links
 
-Apache License 2.0 — © 2026 KoppaJS, Bastian Bensch
+- [KoppaJS documentation](https://github.com/koppajs/koppajs-documentation)
+- [KoppaJS core](https://github.com/koppajs/koppajs-core)
+- [KoppaJS Vite plugin](https://github.com/koppajs/koppajs-vite-plugin)

package/template/index.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>KoppaJS Minimal Starter</title>
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="icon" type="image/png" href="/favicon.png" />
     <link rel="stylesheet" href="/src/style.css" />
   </head>
   <body>

package/template/package.json

@@ -3,8 +3,6 @@
   "version": "1.0.0",
   "private": true,
   "description": "KoppaJS application scaffolded with create-koppajs.",
-  "author": "Bastian Bensch",
-  "license": "Apache-2.0",
   "keywords": [
     "koppajs",
     "koppa",
@@ -14,59 +12,24 @@
     "typescript",
     "web-components"
   ],
-  "packageManager": "pnpm@10.12.1",
+  "packageManager": "pnpm@10.33.2",
   "engines": {
-    "node": ">=22",
-    "pnpm": ">=10"
+    "node": ">=22.12.0",
+    "pnpm": ">=10.24.0"
   },
   "scripts": {
     "dev": "vite --host",
     "build": "tsc --noEmit && vite build",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier . --write --ignore-unknown",
-    "format:check": "prettier . --check --ignore-unknown",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:run": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "pnpm build && playwright test",
-    "test:e2e:headed": "pnpm build && playwright test --headed",
-    "test:e2e:ui": "pnpm build && playwright test --ui",
-    "check": "pnpm lint && pnpm format:check && pnpm typecheck && pnpm test:run && pnpm build",
-    "validate": "pnpm check && playwright test",
-    "release:check": "pnpm validate",
     "typecheck": "tsc --noEmit",
-    "serve": "vite preview",
-    "serve:e2e": "vite preview --host 127.0.0.1 --strictPort --port 4173",
-    "prepare": "husky"
+    "serve": "vite preview"
   },
   "dependencies": {
-    "@koppajs/koppajs-core": "^3.0.7"
+    "@koppajs/koppajs-core": "3.0.7"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.1.0",
-    "@commitlint/config-conventional": "^20.0.0",
-    "@eslint/js": "^10.0.1",
-    "@koppajs/koppajs-vite-plugin": "^1.0.4",
-    "@playwright/test": "^1.58.2",
-    "@types/node": "^25.4.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "eslint": "^10.0.3",
-    "globals": "^17.4.0",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.3.3",
-    "prettier": "^3.8.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.0",
-    "vite": "7.2.6",
-    "vitest": "^4.0.18"
-  },
-  "lint-staged": {
-    "*.{js,mjs,cjs,ts,mts,cts}": [
-      "eslint --fix",
-      "prettier --write"
-    ],
-    "*.{css,html,json,md,yml,yaml}": "prettier --write"
+    "@koppajs/koppajs-vite-plugin": "1.0.4",
+    "@types/node": "25.6.0",
+    "typescript": "5.9.3",
+    "vite": "7.3.2"
   }
 }

package/template/src/app-view.kpa

@@ -1,6 +1,6 @@
 [template]
   <div class="app-root">
-    <img src="https://public-assets-1b57ca06-687a-4142-a525-0635f7649a5c.s3.eu-central-1.amazonaws.com/koppajs/koppajs-logo-text-900x226.png" width="420" alt="KoppaJS Logo" class="logo">
+    <img src="/koppajs-logo.png" width="420" alt="KoppaJS Logo" class="logo">
     <p class="subtitle">Minimal Starter</p>
     <counter-component></counter-component>
   </div>
@@ -31,5 +31,3 @@
     opacity: 0.8;
   }
 [/css]
-
-

package/template/tsconfig.json

@@ -10,17 +10,10 @@
     "forceConsistentCasingInFileNames": true,
     "noEmit": true
   },
-  "include": [
-    "src/**/*.ts",
-    "tests/**/*.ts",
-    "playwright.config.ts",
-    "vite.config.d.mts"
-  ],
+  "include": ["src/**/*.ts"],
   "exclude": [
     "coverage",
     "dist",
-    "node_modules",
-    "playwright-report",
-    "test-results"
+    "node_modules"
   ]
 }