create-nuxt-base 2.5.3 → 2.6.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [2.6.0](https://github.com/lenneTech/nuxt-base-starter/compare/v2.5.3...v2.6.0) (2026-04-17)
+
+
+### Features
+
+* **template:** harden check script with server-start verification and document vendor-mode workflow ([6521650](https://github.com/lenneTech/nuxt-base-starter/commit/65216500261c846a87c66f0cb7a1170a3d0ed2b9))
+
 ### [2.5.3](https://github.com/lenneTech/nuxt-base-starter/compare/v2.5.2...v2.5.3) (2026-04-06)
 
 ### [2.5.2](https://github.com/lenneTech/nuxt-base-starter/compare/v2.5.1...v2.5.2) (2026-04-04)

package/nuxt-base-template/CLAUDE.md

@@ -58,9 +58,51 @@ pnpm run check        # Full quality check (audit + format + lint + types + test
 
 ## Framework: @lenne.tech/nuxt-extensions
 
-This project depends on `@lenne.tech/nuxt-extensions`. The framework source is available in `node_modules/@lenne.tech/nuxt-extensions/` and **MUST** be read when using or debugging framework features.
-
-### Key Source Files (in node_modules/@lenne.tech/nuxt-extensions/)
+This project consumes the framework in one of two modes:
+
+- **npm mode (default):** `@lenne.tech/nuxt-extensions` is installed as
+  an npm dependency; framework source lives in
+  `node_modules/@lenne.tech/nuxt-extensions/`. Registered in
+  `nuxt.config.ts` via the module string `'@lenne.tech/nuxt-extensions'`.
+- **vendor mode:** framework source is copied directly into
+  `app/core/` as first-class project code. No
+  `@lenne.tech/nuxt-extensions` npm dependency. Baseline + patch log
+  live in `app/core/VENDOR.md`. Updated via
+  `/lt-dev:frontend:update-nuxt-extensions-core`. Detect via:
+  `test -f app/core/VENDOR.md`.
+
+**ALWAYS read the actual framework source** before guessing behavior —
+in npm mode from `node_modules/@lenne.tech/nuxt-extensions/`, in
+vendor mode directly from `app/core/`.
+
+### Vendor Modification Policy
+
+When this project is in vendor mode, the copy in `app/core/` exists
+so Claude Code can read framework internals directly — it is a
+**comprehension aid**, not a fork. Only edit `app/core/` when the
+change is **generally useful to every nuxt-extensions consumer**:
+
+- Bugfixes that apply to every consumer
+- Broad framework enhancements (new composables, better defaults,
+  SSR fixes)
+- Security vulnerability fixes
+- Type/config compatibility fixes every consumer would hit
+
+**Everything else stays out of `app/core/`.** Project-specific
+business rules, customer branding, and proprietary integrations
+belong in project code (`app/composables/`, `app/components/`,
+`app/middleware/`, plugin overrides).
+
+**Generally-useful changes MUST be submitted as an upstream PR** to
+`github.com/lenneTech/nuxt-extensions`. Run
+`/lt-dev:frontend:contribute-nuxt-extensions-core` to prepare the PR
+— the agent filters cosmetic commits, categorizes each local change
+as upstream-candidate vs. project-specific, and writes PR drafts for
+human review. Letting useful fixes rot in a single project's vendor
+tree is an anti-pattern: they belong upstream so every consumer
+benefits and the local patch disappears on the next sync.
+
+### Key Source Files (in node_modules/@lenne.tech/nuxt-extensions/ — npm mode; replace prefix with app/core/ in vendor mode)
 
 | File                        | Purpose                                                    |
 | --------------------------- | ---------------------------------------------------------- |
@@ -75,11 +117,12 @@ This project depends on `@lenne.tech/nuxt-extensions`. The framework source is a
 
 ### Rules
 
-1. **ALWAYS read actual source code** from `node_modules/@lenne.tech/nuxt-extensions/` before guessing framework behavior
+1. **ALWAYS read actual source code** before guessing framework behavior — from `node_modules/@lenne.tech/nuxt-extensions/` in npm mode, or from `app/core/` in vendor mode
 2. **NEVER re-implement** functionality that nuxt-extensions already provides — check composables first
 3. **Use `useBetterAuth()`** for authentication — never implement auth manually
 4. **When debugging auth issues**, read the auth proxy server route and middleware source
-5. **Check `dist/runtime/composables/`** before creating new composables — may already exist
+5. **Check runtime composables** before creating new composables — may already exist
+6. **In vendor mode**, only edit `app/core/` for generally-useful changes and submit them upstream via `/lt-dev:frontend:contribute-nuxt-extensions-core`. Project-specific code belongs outside `app/core/`.
 
 ## Authentication
 

package/nuxt-base-template/package.json

@@ -11,9 +11,9 @@
   },
   "scripts": {
     "c": "pnpm run check",
-    "check": "pnpm audit && pnpm run format:check && pnpm run lint && pnpm test && pnpm run build && pnpm start",
-    "check:fix": "pnpm install && pnpm audit --fix && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && pnpm start",
-    "check:naf": "pnpm install && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && pnpm start",
+    "check": "pnpm audit && pnpm run format:check && pnpm run lint && pnpm test && pnpm run build && bash scripts/check-server-start.sh",
+    "check:fix": "pnpm install && pnpm audit --fix && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && bash scripts/check-server-start.sh",
+    "check:naf": "pnpm install && pnpm run format && pnpm run lint:fix && pnpm test && pnpm run build && bash scripts/check-server-start.sh",
     "cf": "pnpm run check:fix",
     "cnaf": "pnpm run check:naf",
     "init": "pnpm install",

package/nuxt-base-template/scripts/check-server-start.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -e
+
+# Temp file for server output
+LOG_FILE=$(mktemp)
+
+# Start the built Nuxt server in background, redirect output to log file
+# The build step already ran before this script is called
+node .output/server/index.mjs > "$LOG_FILE" 2>&1 &
+SERVER_PID=$!
+
+# Show log output in real-time
+tail -f "$LOG_FILE" &
+TAIL_PID=$!
+
+# Ensure cleanup on exit: kill server, tail, and remove temp file
+trap 'kill $SERVER_PID $TAIL_PID 2>/dev/null; wait $SERVER_PID $TAIL_PID 2>/dev/null || true; rm -f "$LOG_FILE"' EXIT
+
+# Wait for the Nitro server ready message (max 60 seconds)
+for i in $(seq 1 60); do
+  if grep -q "Listening on\|Nitro ready\|Local:" "$LOG_FILE" 2>/dev/null; then
+    echo ""
+    echo "Server started successfully - check complete"
+    exit 0
+  fi
+  # Check if server process died unexpectedly
+  if ! kill -0 $SERVER_PID 2>/dev/null; then
+    echo ""
+    echo "Server process exited unexpectedly"
+    exit 1
+  fi
+  sleep 1
+done
+
+echo ""
+echo "Server failed to start within 60 seconds"
+exit 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nuxt-base",
-  "version": "2.5.3",
+  "version": "2.6.0",
   "description": "Starter to generate a configured environment with VueJS, Nuxt, Tailwind, Linting, Unit Tests, Playwright etc.",
   "license": "MIT",
   "author": "lenne.Tech GmbH",