create-quadrokit 0.2.5 → 0.2.7

package/README.md

@@ -16,27 +16,29 @@ bun create-quadrokit/src/index.ts --template dashboard --dir /path/to/my-app
 | `--template <name>` | `dashboard` \| `website` \| `ecommerce` \| `admin-shell` |
 | `--dir <path>` | Target directory relative to cwd (created; must be empty if it already exists) |
 | `--name <name>` | Same as `--dir` (project folder name); ignored if `--dir` is set |
-| `-y` / `--yes` | Non-interactive: requires `--template`; uses `quadro-<template>` as the directory unless `--dir` / `--name` is set; runs git init and install without prompting (override with `--no-git` / `--no-install`) |
+| `-y` / `--yes` | Non-interactive: requires `--template`; uses `quadro-<template>` as the directory unless `--dir` / `--name` is set; copies `.env.example` → `.env`, runs git init and install without prompting (override with `--no-copy-env` / `--no-git` / `--no-install`) |
 | `-h` / `--help` | Print usage and exit |
 | `--keep-workspace` | Keep `workspace:*` in `package.json` (for development inside the QuadroKit monorepo only) |
 | `--git` / `--no-git` | Initialize a git repo after scaffolding (skip the prompt) |
 | `--install` / `--no-install` | Run `bun install` or `npm install` after scaffolding (skip the prompt) |
+| `--copy-env` / `--no-copy-env` | Copy `.env.example` to `.env` after scaffolding (skip the prompt) |
 
 The banner shows **create-quadrokit**’s package version (e.g. `v0.2.2`).
 
 On start, the CLI prints a short **prerequisites** check (Node.js, Bun, Git). Node 18+ is required; Bun is optional (falls back to npm for installs). Git is only needed if you choose to init a repository.
 
-Interactive mode: run without `--template` / `--dir` / `--name` to be prompted. If the project directory already exists and is **not empty**, you are asked again for a different name. You are then asked about **git** and **install** unless `-y` or the explicit flags above apply.
+Interactive mode: run without `--template` / `--dir` / `--name` to be prompted. If the project directory already exists and is **not empty**, you are asked again for a different name. You are then asked whether to copy **`.env.example` → `.env`**, then about **git** and **install**, unless `-y` or the explicit flags above apply.
 
 ## What it does
 
 1. Copies the chosen template from `create-quadrokit/templates/<name>` when installed from npm, or `packages/templates/<name>` when you run the CLI from the monorepo (skips `node_modules`, `dist`, `.quadrokit`, lockfiles).
-2. Overlays **`template-common/`** (shared across all templates): `.env.example`, `tsconfig*.json`, `postcss.config.js`, `biome.json`, `src/vite-env.d.ts`, `.cursor/rules/commitlint-conventional.mdc`, etc. In the monorepo, run `bun run sync:template-common` before template `build`/`typecheck` (also runs as part of root `bun run build`).
-3. Rewrites `src/lib/quadro-client.ts` to import from `../../.quadrokit/generated/client.gen.js`.
+2. Overlays **`template-common/`** (shared across all templates): `.env.example`, `vite.config.ts`, `tsconfig*.json`, `postcss.config.js`, `biome.json`, `src/vite-env.d.ts`, `.cursor/rules/commitlint-conventional.mdc`, etc. In the monorepo, `packages/templates/*` receives the same overlay via `bun run sync:template-common` (root **postinstall** and `bun run build`); those paths are gitignored under `packages/templates/` so only `template-common/` is the source of truth in git.
+3. Rewrites `src/lib/quadro-client.ts` to import from `@quadrokit/generated/client.gen.js` (alias in `vite.config.ts` / `tsconfig.app.json`).
 4. Removes `@quadrokit/sample-client` and rewrites `workspace:*` on `@quadrokit/*` deps to `^<version>` matching **create-quadrokit**’s own `package.json` `version` (run `bun run version:set` at repo root to bump public packages) unless `--keep-workspace`.
 5. Writes `QUADROKIT.md` with proxy and `quadrokit:generate` instructions. Does **not** copy `.quadrokit/generated` — run `bun run quadrokit:generate` after install.
 6. Adds a root `.gitignore` (unless the template already shipped one).
-7. Optionally runs `git init` and installs dependencies (`bun` if available, otherwise `npm`).
+7. Optionally copies `.env.example` to `.env` (prompt, or defaults with `-y`; use `--no-copy-env` to skip).
+8. Optionally runs `git init` and installs dependencies (`bun` if available, otherwise `npm`).
 
 ## Published usage (future)
 

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
-import { readdir, readFile, stat, writeFile } from 'node:fs/promises';
+import { copyFile, readdir, readFile, stat, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import prompts from 'prompts';
@@ -63,11 +63,14 @@ Options:
   --dir <path>          Project directory (relative to cwd; must not exist or be empty)
   --name <name>         Same as --dir when --dir is omitted
   -y, --yes             Non-interactive: requires --template; uses quadro-<template> as directory
-                        unless --dir / --name; runs git init + install (override with --no-git / --no-install)
+                        unless --dir / --name; copies .env.example → .env, runs git init + install
+                        (override with --no-copy-env / --no-git / --no-install)
   --git                 Initialize a git repository (skips prompt)
   --no-git              Do not run git init
   --install             Install dependencies after scaffold (skips prompt)
   --no-install          Do not install dependencies
+  --copy-env            Copy .env.example to .env (skips prompt)
+  --no-copy-env         Do not copy .env.example to .env
   --keep-workspace      Keep workspace:* @quadrokit deps (monorepo development only)
   -h, --help            Show this help
 
@@ -130,6 +133,7 @@ function parseArgs(argv) {
     /** `undefined` = prompt later (unless yes) */
     let initGit;
     let installDeps;
+    let copyEnvFile;
     for (let i = 0; i < argv.length; i++) {
         const a = argv[i];
         if (a === '--template' && argv[i + 1]) {
@@ -159,11 +163,17 @@ function parseArgs(argv) {
         else if (a === '--no-install') {
             installDeps = false;
         }
+        else if (a === '--copy-env') {
+            copyEnvFile = true;
+        }
+        else if (a === '--no-copy-env') {
+            copyEnvFile = false;
+        }
     }
     if (!dir && name) {
         dir = name;
     }
-    return { template, dir, keepWorkspace, yes, initGit, installDeps };
+    return { template, dir, keepWorkspace, yes, initGit, installDeps, copyEnvFile };
 }
 async function pathExists(p) {
     try {
@@ -319,7 +329,7 @@ async function writeStandaloneBiome(dest, keepWorkspace) {
 }
 async function writeQuadroClientImport(dest) {
     const p = path.join(dest, 'src', 'lib', 'quadro-client.ts');
-    const body = `import { createClient } from '../../.quadrokit/generated/client.gen.mjs';
+    const body = `import { createClient } from '@quadrokit/generated/client.gen.js';
 
 /** Same-origin \`/rest\` in dev (Vite proxy) and production (reverse proxy). */
 export const quadro = createClient({ baseURL: '/rest' });
@@ -334,7 +344,7 @@ Created with **create-quadrokit** (template: \`${template}\`).
 ## Next steps
 
 1. \`cd ${path.basename(dest)}\` and install dependencies (\`bun install\` or \`npm install\`).
-2. Copy \`.env.example\` to \`.env\` and set \`VITE_4D_ORIGIN\` to your 4D web server (used for the dev proxy and as the default catalog origin for generate).
+2. If \`.env\` is missing, copy \`.env.example\` to \`.env\`. Set \`VITE_4D_ORIGIN\` to your 4D web server (used for the dev proxy and as the default catalog origin for generate). The scaffold CLI can copy this file for you when asked.
 
 3. Generate the typed REST client (required before \`dev\` / \`build\`). The CLI is \`quadrokit-client\` from \`@quadrokit/client\` (reads \`.env\` in the project cwd for defaults):
 
@@ -358,6 +368,22 @@ Production: serve the SPA and reverse-proxy \`/rest\` to 4D on the **same host**
 `;
     await writeFile(path.join(dest, 'QUADROKIT.md'), text, 'utf8');
 }
+/** Copy `.env.example` → `.env` when the latter does not exist. */
+async function copyEnvExampleToEnv(dest) {
+    const from = path.join(dest, '.env.example');
+    const to = path.join(dest, '.env');
+    if (!(await pathExists(from))) {
+        console.warn('  ⚠️  .env.example missing — skipped env copy.\n');
+        return false;
+    }
+    if (await pathExists(to)) {
+        console.log('  ⚠️  .env already exists — skipped copying .env.example.\n');
+        return false;
+    }
+    await copyFile(from, to);
+    console.log('  ✅  Copied .env.example → .env\n');
+    return true;
+}
 async function writeGitignore(dest) {
     const p = path.join(dest, '.gitignore');
     if (await pathExists(p)) {
@@ -385,7 +411,7 @@ async function main() {
         printHelp(readPackageVersion());
         process.exit(0);
     }
-    const { template: tArg, dir: dirArg, keepWorkspace, yes: yesFlag, initGit: gitFlag, installDeps: installFlag, } = parseArgs(argv);
+    const { template: tArg, dir: dirArg, keepWorkspace, yes: yesFlag, initGit: gitFlag, installDeps: installFlag, copyEnvFile: copyEnvFlag, } = parseArgs(argv);
     printWelcome(readPackageVersion());
     const prereqs = checkPrereqs();
     printPrereqReport(prereqs);
@@ -427,6 +453,28 @@ async function main() {
     await writeReadme(dest, template);
     await writeGitignore(dest);
     console.log(`\n  🎉  Project files are ready at ${'\u001b[1m'}${dest}${'\u001b[0m'}\n`);
+    let copyEnv = copyEnvFlag;
+    if (copyEnv === undefined) {
+        if (yesFlag) {
+            copyEnv = true;
+        }
+        else {
+            const envPrompt = await prompts({
+                type: 'confirm',
+                name: 'v',
+                message: 'Copy .env.example to .env?',
+                initial: true,
+            });
+            if (typeof envPrompt.v !== 'boolean') {
+                process.exit(1);
+            }
+            copyEnv = envPrompt.v;
+        }
+    }
+    let envCopiedOk = false;
+    if (copyEnv) {
+        envCopiedOk = await copyEnvExampleToEnv(dest);
+    }
     let initGit = gitFlag;
     if (initGit === undefined) {
         if (yesFlag) {
@@ -493,10 +541,21 @@ async function main() {
     const pm = prereqs.bunOk ? 'bun' : 'npm';
     const runDev = prereqs.bunOk ? 'bun run dev' : 'npm run dev';
     const installLine = installDeps ? `    →  ${runDev}` : `    →  ${pm} install\n    →  ${runDev}`;
+    const hasEnvFile = await pathExists(path.join(dest, '.env'));
+    let envHint;
+    if (envCopiedOk || hasEnvFile) {
+        envHint = `    →  Set VITE_4D_ORIGIN in .env (if needed)`;
+    }
+    else if (!copyEnv) {
+        envHint = `    →  Copy .env.example → .env and set VITE_4D_ORIGIN`;
+    }
+    else {
+        envHint = `    →  Create .env from .env.example and set VITE_4D_ORIGIN`;
+    }
     console.log(`  🚀🚀  Next steps
     →  cd ${path.basename(dest)}
 ${installLine}
-    →  Copy .env.example → .env and set VITE_4D_ORIGIN
+${envHint}
 
   Happy building! ✨
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-quadrokit",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Scaffold a QuadroKit Vite + React app from a template",
   "type": "module",
   "bin": "./dist/index.mjs",

package/template-common/tsconfig.app.json

@@ -1,6 +1,7 @@
 {
   "extends": "./tsconfig.base.json",
   "compilerOptions": {
+    "baseUrl": ".",
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
     "useDefineForClassFields": true,
     "lib": ["ES2022", "DOM", "DOM.Iterable"],
@@ -9,8 +10,9 @@
     "jsx": "react-jsx",
     "verbatimModuleSyntax": true,
     "paths": {
-      "@/*": ["./src/*"]
+      "@/*": ["./src/*"],
+      "@quadrokit/generated/*": [".quadrokit/generated/*"]
     }
   },
-  "include": ["src/**/*.ts", "src/**/*.tsx"]
+  "include": ["src/**/*.ts", "src/**/*.tsx", ".quadrokit/generated/**/*.ts"]
 }

package/{templates/ecommerce → template-common}/vite.config.ts

@@ -11,6 +11,7 @@ export default defineConfig(({ mode }) => {
     resolve: {
       alias: {
         '@': path.resolve(__dirname, 'src'),
+        '@quadrokit/generated': path.resolve(__dirname, '.quadrokit/generated'),
       },
     },
     server: {

package/templates/README.md

@@ -11,17 +11,19 @@ Vite + React 19 + React Router 7 + **Tailwind 3.4** + **i18next** + **react-hook
 
 ## Monorepo
 
+Shared config (Vite, TypeScript, Biome, PostCSS, `.env.example`, etc.) lives in **`../../create-quadrokit/template-common/`** and is copied into each template by **`bun run sync:template-common`** (runs on root **postinstall** and before template builds). Do not edit those files inside `packages/templates/<name>/`—change **`template-common`** and re-sync.
+
 ```bash
 cd packages/templates/dashboard   # or website / ecommerce / admin-shell
-bun install   # from repo root once
+bun install   # from repo root once (runs sync:template-common)
 bun run dev
 ```
 
-Copy [`.env.example`](dashboard/.env.example) to `.env` and set `VITE_4D_ORIGIN`.
+Copy [`template-common/.env.example`](../../create-quadrokit/template-common/.env.example) to `.env` in the template directory and set `VITE_4D_ORIGIN`.
 
 ## Biome (per template)
 
-Each template has a [`biome.json`](dashboard/biome.json) with `"root": false` and `"extends": "//"` (Biome v2 monorepo pattern: inherit repo root, scope files to that template). `vcs.useIgnoreFile` is off so Biome does not require a `.gitignore` next to the template.
+Each template uses a `biome.json` (from `template-common`) with `"root": false` and `"extends": "//"` (Biome v2 monorepo pattern: inherit repo root, scope files to that template). `vcs.useIgnoreFile` is off so Biome does not require a `.gitignore` next to the template.
 
 | Script | Purpose |
 |--------|---------|

package/templates/admin-shell/.cursor/rules/commitlint-conventional.mdc

@@ -1,47 +0,0 @@
----
-description: Commit messages must follow Conventional Commits (commitlint @commitlint/config-conventional)
-alwaysApply: true
----
-
-# Git commits (Conventional Commits / commitlint)
-
-When proposing or writing **commit messages** (including one-line suggestions, full messages, or PR squash titles), use **Conventional Commits** compatible with **@commitlint/config-conventional**.
-
-## Header format
-
-```
-<type>(<optional-scope>): <short description>
-```
-
-- **type** (pick one): `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
-- **scope** (optional): lowercase, short package or area (e.g. `client`, `templates`, `ui`, `create-quadrokit`)
-- **description**: imperative mood, **lowercase**, **no trailing period**, **≤ ~72 characters** for the subject line
-
-## Breaking changes
-
-- Add `!` after type or scope: `feat(api)!: remove legacy login endpoint`
-- Or explain in the body with a line starting with `BREAKING CHANGE:`
-
-## Body and footer (when needed)
-
-- Separate body from subject with a blank line.
-- Wrap body at ~100 chars.
-- Footer: `Refs: #123` / `Fixes: #123` if applicable.
-
-## Examples
-
-```
-feat(client): add entity set release helper
-
-fix(templates): correct vite proxy target env var
-
-chore: bump biome to 2.4.10
-
-docs(readme): document ci:quick script
-```
-
-## Do not
-
-- Vague subjects: `update`, `fix stuff`, `wip`
-- End the subject line with a period
-- Use title case for the description (use sentence case / lowercase)

package/templates/admin-shell/.env.example

@@ -1,9 +0,0 @@
-# Origin of your 4D web server (REST). The Vite dev server proxies /rest here.
-VITE_4D_ORIGIN=http://127.0.0.1:7080
-
-# Generator only (quadrokit:generate): multipart accessKey → 4DAdminSID cookie for fetching /rest/$catalog.
-# Not used by the browser runtime.
-# QUADROKIT_ACCESS_KEY=
-# QUADROKIT_LOGIN_URL=https://127.0.0.1:7443/api/login
-# QUADROKIT_GENERATE_VERBOSE=1
-# QUADROKIT_INSECURE_TLS=1

package/templates/admin-shell/biome.json

@@ -1,12 +0,0 @@
-{
-  "root": false,
-  "extends": "//",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
-  "files": {
-    "includes": ["**", "!**/node_modules", "!**/dist", "!**/.quadrokit"]
-  }
-}

package/templates/admin-shell/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}

package/templates/admin-shell/src/vite-env.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="vite/client" />
-
-interface ImportMetaEnv {
-  readonly VITE_4D_ORIGIN?: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}

package/templates/admin-shell/tsconfig.app.json

@@ -1,16 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"]
-}

package/templates/admin-shell/tsconfig.base.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true
-  }
-}

package/templates/admin-shell/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "files": [],
-  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
-}

package/templates/admin-shell/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "noEmit": true,
-    "moduleDetection": "force",
-    "types": ["node"]
-  },
-  "include": ["vite.config.ts", "tailwind.config.ts"]
-}

package/templates/admin-shell/vite.config.ts

@@ -1,25 +0,0 @@
-import path from 'node:path'
-import react from '@vitejs/plugin-react'
-import { defineConfig, loadEnv } from 'vite'
-
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), '')
-  const target4d = env.VITE_4D_ORIGIN ?? 'http://127.0.0.1:7080'
-
-  return {
-    plugins: [react()],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, 'src'),
-      },
-    },
-    server: {
-      proxy: {
-        '/rest': {
-          target: target4d,
-          changeOrigin: true,
-        },
-      },
-    },
-  }
-})

package/templates/dashboard/.cursor/rules/commitlint-conventional.mdc

@@ -1,47 +0,0 @@
----
-description: Commit messages must follow Conventional Commits (commitlint @commitlint/config-conventional)
-alwaysApply: true
----
-
-# Git commits (Conventional Commits / commitlint)
-
-When proposing or writing **commit messages** (including one-line suggestions, full messages, or PR squash titles), use **Conventional Commits** compatible with **@commitlint/config-conventional**.
-
-## Header format
-
-```
-<type>(<optional-scope>): <short description>
-```
-
-- **type** (pick one): `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
-- **scope** (optional): lowercase, short package or area (e.g. `client`, `templates`, `ui`, `create-quadrokit`)
-- **description**: imperative mood, **lowercase**, **no trailing period**, **≤ ~72 characters** for the subject line
-
-## Breaking changes
-
-- Add `!` after type or scope: `feat(api)!: remove legacy login endpoint`
-- Or explain in the body with a line starting with `BREAKING CHANGE:`
-
-## Body and footer (when needed)
-
-- Separate body from subject with a blank line.
-- Wrap body at ~100 chars.
-- Footer: `Refs: #123` / `Fixes: #123` if applicable.
-
-## Examples
-
-```
-feat(client): add entity set release helper
-
-fix(templates): correct vite proxy target env var
-
-chore: bump biome to 2.4.10
-
-docs(readme): document ci:quick script
-```
-
-## Do not
-
-- Vague subjects: `update`, `fix stuff`, `wip`
-- End the subject line with a period
-- Use title case for the description (use sentence case / lowercase)

package/templates/dashboard/.env.example

@@ -1,9 +0,0 @@
-# Origin of your 4D web server (REST). The Vite dev server proxies /rest here.
-VITE_4D_ORIGIN=http://127.0.0.1:7080
-
-# Generator only (quadrokit:generate): multipart accessKey → 4DAdminSID cookie for fetching /rest/$catalog.
-# Not used by the browser runtime.
-# QUADROKIT_ACCESS_KEY=
-# QUADROKIT_LOGIN_URL=https://127.0.0.1:7443/api/login
-# QUADROKIT_GENERATE_VERBOSE=1
-# QUADROKIT_INSECURE_TLS=1

package/templates/dashboard/biome.json

@@ -1,12 +0,0 @@
-{
-  "root": false,
-  "extends": "//",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
-  "files": {
-    "includes": ["**", "!**/node_modules", "!**/dist", "!**/.quadrokit"]
-  }
-}

package/templates/dashboard/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}

package/templates/dashboard/src/vite-env.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="vite/client" />
-
-interface ImportMetaEnv {
-  readonly VITE_4D_ORIGIN?: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}

package/templates/dashboard/tsconfig.app.json

@@ -1,16 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"]
-}

package/templates/dashboard/tsconfig.base.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true
-  }
-}

package/templates/dashboard/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "files": [],
-  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
-}

package/templates/dashboard/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "noEmit": true,
-    "moduleDetection": "force",
-    "types": ["node"]
-  },
-  "include": ["vite.config.ts", "tailwind.config.ts"]
-}

package/templates/dashboard/vite.config.ts

@@ -1,25 +0,0 @@
-import path from 'node:path'
-import react from '@vitejs/plugin-react'
-import { defineConfig, loadEnv } from 'vite'
-
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), '')
-  const target4d = env.VITE_4D_ORIGIN ?? 'http://127.0.0.1:7080'
-
-  return {
-    plugins: [react()],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, 'src'),
-      },
-    },
-    server: {
-      proxy: {
-        '/rest': {
-          target: target4d,
-          changeOrigin: true,
-        },
-      },
-    },
-  }
-})

package/templates/ecommerce/.cursor/rules/commitlint-conventional.mdc

@@ -1,47 +0,0 @@
----
-description: Commit messages must follow Conventional Commits (commitlint @commitlint/config-conventional)
-alwaysApply: true
----
-
-# Git commits (Conventional Commits / commitlint)
-
-When proposing or writing **commit messages** (including one-line suggestions, full messages, or PR squash titles), use **Conventional Commits** compatible with **@commitlint/config-conventional**.
-
-## Header format
-
-```
-<type>(<optional-scope>): <short description>
-```
-
-- **type** (pick one): `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
-- **scope** (optional): lowercase, short package or area (e.g. `client`, `templates`, `ui`, `create-quadrokit`)
-- **description**: imperative mood, **lowercase**, **no trailing period**, **≤ ~72 characters** for the subject line
-
-## Breaking changes
-
-- Add `!` after type or scope: `feat(api)!: remove legacy login endpoint`
-- Or explain in the body with a line starting with `BREAKING CHANGE:`
-
-## Body and footer (when needed)
-
-- Separate body from subject with a blank line.
-- Wrap body at ~100 chars.
-- Footer: `Refs: #123` / `Fixes: #123` if applicable.
-
-## Examples
-
-```
-feat(client): add entity set release helper
-
-fix(templates): correct vite proxy target env var
-
-chore: bump biome to 2.4.10
-
-docs(readme): document ci:quick script
-```
-
-## Do not
-
-- Vague subjects: `update`, `fix stuff`, `wip`
-- End the subject line with a period
-- Use title case for the description (use sentence case / lowercase)

package/templates/ecommerce/.env.example

@@ -1,9 +0,0 @@
-# Origin of your 4D web server (REST). The Vite dev server proxies /rest here.
-VITE_4D_ORIGIN=http://127.0.0.1:7080
-
-# Generator only (quadrokit:generate): multipart accessKey → 4DAdminSID cookie for fetching /rest/$catalog.
-# Not used by the browser runtime.
-# QUADROKIT_ACCESS_KEY=
-# QUADROKIT_LOGIN_URL=https://127.0.0.1:7443/api/login
-# QUADROKIT_GENERATE_VERBOSE=1
-# QUADROKIT_INSECURE_TLS=1

package/templates/ecommerce/biome.json

@@ -1,12 +0,0 @@
-{
-  "root": false,
-  "extends": "//",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
-  "files": {
-    "includes": ["**", "!**/node_modules", "!**/dist", "!**/.quadrokit"]
-  }
-}

package/templates/ecommerce/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}

package/templates/ecommerce/src/vite-env.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="vite/client" />
-
-interface ImportMetaEnv {
-  readonly VITE_4D_ORIGIN?: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}

package/templates/ecommerce/tsconfig.app.json

@@ -1,16 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"]
-}

package/templates/ecommerce/tsconfig.base.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true
-  }
-}

package/templates/ecommerce/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "files": [],
-  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
-}

package/templates/ecommerce/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "noEmit": true,
-    "moduleDetection": "force",
-    "types": ["node"]
-  },
-  "include": ["vite.config.ts", "tailwind.config.ts"]
-}

package/templates/website/.cursor/rules/commitlint-conventional.mdc

@@ -1,47 +0,0 @@
----
-description: Commit messages must follow Conventional Commits (commitlint @commitlint/config-conventional)
-alwaysApply: true
----
-
-# Git commits (Conventional Commits / commitlint)
-
-When proposing or writing **commit messages** (including one-line suggestions, full messages, or PR squash titles), use **Conventional Commits** compatible with **@commitlint/config-conventional**.
-
-## Header format
-
-```
-<type>(<optional-scope>): <short description>
-```
-
-- **type** (pick one): `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
-- **scope** (optional): lowercase, short package or area (e.g. `client`, `templates`, `ui`, `create-quadrokit`)
-- **description**: imperative mood, **lowercase**, **no trailing period**, **≤ ~72 characters** for the subject line
-
-## Breaking changes
-
-- Add `!` after type or scope: `feat(api)!: remove legacy login endpoint`
-- Or explain in the body with a line starting with `BREAKING CHANGE:`
-
-## Body and footer (when needed)
-
-- Separate body from subject with a blank line.
-- Wrap body at ~100 chars.
-- Footer: `Refs: #123` / `Fixes: #123` if applicable.
-
-## Examples
-
-```
-feat(client): add entity set release helper
-
-fix(templates): correct vite proxy target env var
-
-chore: bump biome to 2.4.10
-
-docs(readme): document ci:quick script
-```
-
-## Do not
-
-- Vague subjects: `update`, `fix stuff`, `wip`
-- End the subject line with a period
-- Use title case for the description (use sentence case / lowercase)

package/templates/website/.env.example

@@ -1,9 +0,0 @@
-# Origin of your 4D web server (REST). The Vite dev server proxies /rest here.
-VITE_4D_ORIGIN=http://127.0.0.1:7080
-
-# Generator only (quadrokit:generate): multipart accessKey → 4DAdminSID cookie for fetching /rest/$catalog.
-# Not used by the browser runtime.
-# QUADROKIT_ACCESS_KEY=
-# QUADROKIT_LOGIN_URL=https://127.0.0.1:7443/api/login
-# QUADROKIT_GENERATE_VERBOSE=1
-# QUADROKIT_INSECURE_TLS=1

package/templates/website/biome.json

@@ -1,12 +0,0 @@
-{
-  "root": false,
-  "extends": "//",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": false
-  },
-  "files": {
-    "includes": ["**", "!**/node_modules", "!**/dist", "!**/.quadrokit"]
-  }
-}

package/templates/website/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}

package/templates/website/src/vite-env.d.ts

@@ -1,9 +0,0 @@
-/// <reference types="vite/client" />
-
-interface ImportMetaEnv {
-  readonly VITE_4D_ORIGIN?: string
-}
-
-interface ImportMeta {
-  readonly env: ImportMetaEnv
-}

package/templates/website/tsconfig.app.json

@@ -1,16 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-    "useDefineForClassFields": true,
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "moduleDetection": "force",
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "verbatimModuleSyntax": true,
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*.ts", "src/**/*.tsx"]
-}

package/templates/website/tsconfig.base.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true
-  }
-}

package/templates/website/tsconfig.json

@@ -1,4 +0,0 @@
-{
-  "files": [],
-  "references": [{ "path": "./tsconfig.app.json" }, { "path": "./tsconfig.node.json" }]
-}

package/templates/website/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "extends": "./tsconfig.base.json",
-  "compilerOptions": {
-    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
-    "noEmit": true,
-    "moduleDetection": "force",
-    "types": ["node"]
-  },
-  "include": ["vite.config.ts", "tailwind.config.ts"]
-}

package/templates/website/vite.config.ts

@@ -1,25 +0,0 @@
-import path from 'node:path'
-import react from '@vitejs/plugin-react'
-import { defineConfig, loadEnv } from 'vite'
-
-export default defineConfig(({ mode }) => {
-  const env = loadEnv(mode, process.cwd(), '')
-  const target4d = env.VITE_4D_ORIGIN ?? 'http://127.0.0.1:7080'
-
-  return {
-    plugins: [react()],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, 'src'),
-      },
-    },
-    server: {
-      proxy: {
-        '/rest': {
-          target: target4d,
-          changeOrigin: true,
-        },
-      },
-    },
-  }
-})