@lark-apaas/coding-template-nestjs-react-fullstack 0.1.0-alpha.1

package/template/package.json

@@ -0,0 +1,202 @@
+{
+  "name": "fullstack-nestjs-template",
+  "version": "2.2.5",
+  "private": true,
+  "flags": {
+    "supportBusinessUser": true,
+    "supportScrollReveal": true,
+    "supportTiptapAndStreamdown": true,
+    "customToaster": true
+  },
+  "scripts": {
+    "dev": "npm run upgrade && ./scripts/dev.sh",
+    "dev:server": "NODE_ENV=development nest start --watch",
+    "dev:client": "NODE_ENV=development vite --config vite.config.ts",
+    "gen:db-schema": "npx -y @lark-apaas/db-schema-sync@latest --output server/database/schema.ts --export-custom-types",
+    "gen:openapi": "echo 'UNSUPPORTED, SKIP'",
+    "build": "./scripts/build.sh",
+    "build:prod": "npm run build:server && npm run build:client",
+    "build:server": "NODE_ENV=production nest build",
+    "build:client": "NODE_ENV=production vite build --config vite.config.ts",
+    "start": "NODE_ENV=production node main.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:e2e": "jest --config test/e2e/jest.config.js",
+    "eslint": "eslint . --quiet",
+    "stylelint": "stylelint client/src/**/*.css --quiet",
+    "type:check": "concurrently -n \"server,client\" -c \"blue,green\" \"npm run type:check:server\" \"npm run type:check:client\"",
+    "type:check:client": "tsc --noEmit --project tsconfig.app.json",
+    "type:check:server": "tsc --noEmit --project tsconfig.node.json",
+    "lint": "node ./scripts/lint.js",
+    "format": "prettier --write \"{server,client,test}/**/*.{js,ts,tsx,json,md}\"",
+    "upgrade": "fullstack-cli sync --disable-gen-openapi"
+  },
+  "dependencies": {
+    "@lark-apaas/fullstack-nestjs-core": "^1.1.22",
+    "@nestjs/axios": "^4.0.1",
+    "@nestjs/common": "^10.4.20",
+    "@nestjs/config": "^3.3.0",
+    "@nestjs/core": "^10.4.20",
+    "@nestjs/platform-express": "^10.4.20",
+    "@nestjs/swagger": "^7.4.2",
+    "@tanstack/react-form": "^1.27.6",
+    "@tanstack/react-query": "^5.90.12",
+    "axios": "^1.12.2",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.2",
+    "crypto-js": "^4.2.0",
+    "dayjs": "^1.11.15",
+    "dotenv": "^17.2.2",
+    "drizzle-orm": "0.44.6",
+    "hbs": "^4.2.0",
+    "reflect-metadata": "^0.1.14",
+    "tslib": "^2.8.1"
+  },
+  "devDependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/modifiers": "^9.0.0",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@headlessui/react": "^2.2.9",
+    "@heroicons/react": "^2.2.0",
+    "@hookform/resolvers": "^5.2.2",
+    "@lark-apaas/client-toolkit": "^1.2.31",
+    "@lark-apaas/fullstack-presets": "^1.1.0",
+    "@lark-apaas/fullstack-vite-preset": "^1.0.1",
+    "@nestjs/cli": "^10.4.9",
+    "@nestjs/testing": "^10.4.20",
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-aspect-ratio": "^1.1.7",
+    "@radix-ui/react-avatar": "^1.1.10",
+    "@radix-ui/react-checkbox": "^1.3.3",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-context-menu": "^2.2.16",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-hover-card": "^1.1.15",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-menubar": "^1.1.16",
+    "@radix-ui/react-navigation-menu": "^1.2.14",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-progress": "^1.1.7",
+    "@radix-ui/react-radio-group": "^1.3.8",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.7",
+    "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-toggle": "^1.1.10",
+    "@radix-ui/react-toggle-group": "^1.1.11",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@reduxjs/toolkit": "^2.9.0",
+    "@shikijs/langs": "^3.21.0",
+    "@shikijs/themes": "^3.21.0",
+    "@tailwindcss/postcss": "^4.1.13",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tiptap/core": "^3.14.0",
+    "@tiptap/extension-code-block": "^3.15.3",
+    "@tiptap/extension-code-block-lowlight": "^3.14.0",
+    "@tiptap/extension-color": "^3.14.0",
+    "@tiptap/extension-highlight": "^3.14.0",
+    "@tiptap/extension-image": "^3.14.0",
+    "@tiptap/extension-link": "^3.14.0",
+    "@tiptap/extension-placeholder": "^3.14.0",
+    "@tiptap/extension-task-item": "^3.15.3",
+    "@tiptap/extension-task-list": "^3.15.3",
+    "@tiptap/extension-text-align": "^3.14.0",
+    "@tiptap/extension-text-style": "^3.14.0",
+    "@tiptap/extension-underline": "^3.14.0",
+    "@tiptap/pm": "^3.15.3",
+    "@tiptap/react": "^3.14.0",
+    "@tiptap/starter-kit": "^3.14.0",
+    "@types/crypto-js": "^4.2.2",
+    "@types/express": "^5.0.3",
+    "@types/hbs": "^4.0.5",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.18.6",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "autoprefixer": "^10.4.21",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "~2.0.1",
+    "cmdk": "^1.1.1",
+    "cobe": "^0.6.5",
+    "concurrently": "^9.2.1",
+    "css-loader": "^7.1.2",
+    "date-fns": "^4.1.0",
+    "echarts": "~5.6.0",
+    "echarts-for-react": "~3.0.2",
+    "embla-carousel-react": "^8.6.0",
+    "es-toolkit": "^1.43.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^9.1.2",
+    "form-data": "^4.0.4",
+    "framer-motion": "~11.13.5",
+    "gsap": "^3.13.0",
+    "html2canvas": "^1.4.1",
+    "input-otp": "^1.4.2",
+    "jest": "^29.7.0",
+    "js-base64": "^3.7.8",
+    "jspdf": "^3.0.3",
+    "lodash": "^4.17.21",
+    "lucide-react": "^0.554.0",
+    "nanoid": "^5.1.6",
+    "next-themes": "^0.4.6",
+    "pinyin-pro": "^3.27.0",
+    "postcss": "^8.5.6",
+    "postcss-import": "^16.1.1",
+    "postcss-loader": "^8.2.0",
+    "prettier": "^3.6.2",
+    "qrcode.react": "^4.2.0",
+    "radix-ui": "^1.4.3",
+    "react": "^19.2.0",
+    "react-countup": "^6.5.3",
+    "react-day-picker": "^9.11.1",
+    "react-dom": "^19.2.0",
+    "react-dropzone": "^14.3.5",
+    "react-error-boundary": "^6.0.0",
+    "react-hook-form": "^7.65.0",
+    "react-redux": "^9.2.0",
+    "react-refresh": "^0.17.0",
+    "react-resizable-panels": "^3.0.6",
+    "react-router-dom": "^6.30.1",
+    "recharts": "^2.15.4",
+    "rxjs": "^7.8.2",
+    "shiki": "^3.21.0",
+    "sonner": "^2.0.7",
+    "streamdown": "^1.6.10",
+    "style-loader": "^4.0.0",
+    "stylelint": "^16.11.0",
+    "tailwind-merge": "~3.4.0",
+    "tailwindcss": "^4.1.13",
+    "ts-jest": "^29.4.3",
+    "ts-node": "^10.9.2",
+    "tw-animate-css": "^1.3.8",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0",
+    "uuid": "11.0.5",
+    "vaul": "^1.1.2",
+    "vite": "^7.3.1",
+    "xlsx": "^0.18.5",
+    "xlsx-js-style": "^1.2.0",
+    "zod": "^3.25.76",
+    "zustand": "~5.0.8"
+  },
+  "overrides": {
+    "dayjs": "^1.11.15"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": [
+      "<rootDir>/server/**/*.spec.ts",
+      "<rootDir>/test/unit/**/*.spec.ts"
+    ]
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "npm": ">=10.0.0"
+  }
+}

package/template/postcss.config.js

@@ -0,0 +1,10 @@
+/**
+ * @type {import('postcss-load-config').Config}
+ */
+module.exports = {
+  plugins: {
+    'postcss-import': {},
+    '@tailwindcss/postcss': {},
+    autoprefixer: {}
+  },
+}

package/template/scripts/build.sh

@@ -0,0 +1,120 @@
+#!/usr/bin/env bash
+# This file is auto-generated by @lark-apaas/fullstack-cli
+set -euo pipefail
+
+ROOT_DIR="$(pwd)"
+OUT_DIR="$ROOT_DIR/dist/server"
+
+# 记录总开始时间
+TOTAL_START=$(node -e "console.log(Date.now())")
+
+# 打印耗时的辅助函数
+print_time() {
+  local start=$1
+  local end=$(node -e "console.log(Date.now())")
+  local elapsed=$((end - start))
+  local seconds=$((elapsed / 1000))
+  local ms=$((elapsed % 1000))
+  echo "   ⏱️  耗时: ${seconds}.$(printf "%03d" $ms)s"
+}
+
+# ==================== 步骤 0 ====================
+echo "🗑️  [0/5] 安装插件"
+STEP_START=$(node -e "console.log(Date.now())")
+npx fullstack-cli action-plugin init
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 1 ====================
+echo "📝 [1/5] 更新 openapi 代码"
+STEP_START=$(node -e "console.log(Date.now())")
+npm run gen:openapi
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 2 ====================
+echo "🗑️  [2/5] 清理 dist 目录"
+STEP_START=$(node -e "console.log(Date.now())")
+rm -rf "$ROOT_DIR/dist"
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 3 ====================
+echo "🔨 [3/5] 并行构建 server 和 client"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 并行构建
+echo "   ├─ 启动 server 构建..."
+npm run build:server > /tmp/build-server.log 2>&1 &
+SERVER_PID=$!
+
+echo "   ├─ 启动 client 构建..."
+npm run build:client > /tmp/build-client.log 2>&1 &
+CLIENT_PID=$!
+
+# 等待两个构建完成
+SERVER_EXIT=0
+CLIENT_EXIT=0
+
+wait $SERVER_PID || SERVER_EXIT=$?
+wait $CLIENT_PID || CLIENT_EXIT=$?
+
+# 检查构建结果
+if [ $SERVER_EXIT -ne 0 ]; then
+  echo "   ❌ Server 构建失败"
+  cat /tmp/build-server.log
+  exit 1
+fi
+
+if [ $CLIENT_EXIT -ne 0 ]; then
+  echo "   ❌ Client 构建失败"
+  cat /tmp/build-client.log
+  exit 1
+fi
+
+echo "   ✅ Server 构建完成"
+echo "   ✅ Client 构建完成"
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 4 ====================
+echo "📦 [4/5] 准备 server 依赖产物"
+STEP_START=$(node -e "console.log(Date.now())")
+
+mkdir -p "$OUT_DIR/dist/client"
+
+# 拷贝 HTML
+cp "$ROOT_DIR/dist/client/"*.html "$OUT_DIR/dist/client/" || true
+
+# 拷贝 run.sh 文件
+cp "$ROOT_DIR/scripts/run.sh" "$OUT_DIR/"
+
+# 清理无用文件
+rm -rf "$ROOT_DIR/dist/scripts"
+rm -rf "$ROOT_DIR/dist/tsconfig.node.tsbuildinfo"
+
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 5 ====================
+echo "✂️  [5/5] 智能依赖裁剪"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
+node "$ROOT_DIR/scripts/prune-smart.js"
+
+print_time $STEP_START
+echo ""
+
+# 总耗时
+echo "构建完成"
+print_time $TOTAL_START
+
+# 输出产物信息
+DIST_SIZE=$(du -sh "$OUT_DIR" | cut -f1)
+NODE_MODULES_SIZE=$(du -sh "$OUT_DIR/node_modules" | cut -f1)
+echo ""
+echo "📊 构建产物统计:"
+echo "   总大小:        $DIST_SIZE"
+echo "   node_modules: $NODE_MODULES_SIZE"
+echo ""

package/template/scripts/dev.js

@@ -0,0 +1,295 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawn, execSync } = require('child_process');
+const readline = require('readline');
+
+// ── Project root ──────────────────────────────────────────────────────────────
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+process.chdir(PROJECT_ROOT);
+
+// ── Load .env ─────────────────────────────────────────────────────────────────
+function loadEnv() {
+  const envPath = path.join(PROJECT_ROOT, '.env');
+  if (!fs.existsSync(envPath)) return;
+  const lines = fs.readFileSync(envPath, 'utf8').split('\n');
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const eqIdx = trimmed.indexOf('=');
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    const value = trimmed.slice(eqIdx + 1).trim();
+    if (!(key in process.env)) {
+      process.env[key] = value;
+    }
+  }
+}
+loadEnv();
+
+// ── Configuration ─────────────────────────────────────────────────────────────
+const LOG_DIR = process.env.LOG_DIR || 'logs';
+const MAX_RESTART_COUNT = process.env.MAX_RESTART_COUNT != null && process.env.MAX_RESTART_COUNT !== ''
+  ? parseInt(process.env.MAX_RESTART_COUNT, 10)
+  : Infinity;
+const RESTART_DELAY = parseInt(process.env.RESTART_DELAY, 10) || 2;
+const MAX_DELAY = 8;
+const SERVER_PORT = process.env.SERVER_PORT || '3000';
+const CLIENT_DEV_PORT = process.env.CLIENT_DEV_PORT || '8080';
+
+fs.mkdirSync(LOG_DIR, { recursive: true });
+
+// ── Logging infrastructure ────────────────────────────────────────────────────
+const devStdLogPath = path.join(LOG_DIR, 'dev.std.log');
+const devLogPath = path.join(LOG_DIR, 'dev.log');
+const devStdLogFd = fs.openSync(devStdLogPath, 'a');
+const devLogFd = fs.openSync(devLogPath, 'a');
+
+function timestamp() {
+  const now = new Date();
+  return (
+    now.getFullYear() + '-' +
+    String(now.getMonth() + 1).padStart(2, '0') + '-' +
+    String(now.getDate()).padStart(2, '0') + ' ' +
+    String(now.getHours()).padStart(2, '0') + ':' +
+    String(now.getMinutes()).padStart(2, '0') + ':' +
+    String(now.getSeconds()).padStart(2, '0')
+  );
+}
+
+/** Write to terminal + dev.std.log */
+function writeOutput(msg) {
+  try { process.stdout.write(msg); } catch {}
+  try { fs.writeSync(devStdLogFd, msg); } catch {}
+}
+
+/** Structured event log → terminal + dev.std.log + dev.log */
+function logEvent(level, name, message) {
+  const msg = `[${timestamp()}] [${level}] [${name}] ${message}\n`;
+  writeOutput(msg);
+  try { fs.writeSync(devLogFd, msg); } catch {}
+}
+
+// ── Process group management ──────────────────────────────────────────────────
+function killProcessGroup(pid, signal) {
+  try {
+    process.kill(-pid, signal);
+  } catch {}
+}
+
+function killOrphansByPort(port) {
+  try {
+    const pids = execSync(`lsof -ti :${port}`, { encoding: 'utf8', timeout: 5000 }).trim();
+    if (pids) {
+      const pidList = pids.split('\n').filter(Boolean);
+      for (const p of pidList) {
+        try { process.kill(parseInt(p, 10), 'SIGKILL'); } catch {}
+      }
+      return pidList;
+    }
+  } catch {}
+  return [];
+}
+
+// ── Process supervision ───────────────────────────────────────────────────────
+let stopping = false;
+const managedProcesses = []; // { name, pid, child }
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Start and supervise a process with auto-restart and log piping.
+ * Returns a promise that resolves when the process loop ends.
+ */
+function startProcess({ name, command, args, cleanupPort }) {
+  const logFilePath = path.join(LOG_DIR, `${name}.std.log`);
+  const logFd = fs.openSync(logFilePath, 'a');
+
+  const entry = { name, pid: null, child: null };
+  managedProcesses.push(entry);
+
+  const run = async () => {
+    let restartCount = 0;
+
+    while (!stopping) {
+      const child = spawn(command, args, {
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: true,
+        cwd: PROJECT_ROOT,
+        env: { ...process.env },
+      });
+
+      entry.pid = child.pid;
+      entry.child = child;
+
+      const startTime = Date.now();
+      logEvent('INFO', name, `Process started (PGID: ${child.pid}): ${command} ${args.join(' ')}`);
+
+      // Pipe stdout and stderr through readline for timestamped logging
+      const pipeLines = (stream) => {
+        const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+        rl.on('line', (line) => {
+          const msg = `[${timestamp()}] [${name}] ${line}\n`;
+          try { fs.writeSync(logFd, msg); } catch {}
+          writeOutput(msg);
+        });
+      };
+      if (child.stdout) pipeLines(child.stdout);
+      if (child.stderr) pipeLines(child.stderr);
+
+      // Wait for the direct child to exit.
+      // NOTE: must use 'exit', not 'close'. With shell:true, grandchild processes
+      // (e.g. nest's server) inherit stdout pipes. 'close' won't fire until ALL
+      // pipe holders exit, causing dev.js to hang when npm/nest dies but server survives.
+      const exitCode = await new Promise((resolve) => {
+        child.on('exit', (code) => resolve(code ?? 1));
+        child.on('error', () => resolve(1));
+      });
+
+      // Kill the entire process group
+      if (entry.pid) {
+        killProcessGroup(entry.pid, 'SIGTERM');
+        await sleep(2000);
+        killProcessGroup(entry.pid, 'SIGKILL');
+      }
+      entry.pid = null;
+      entry.child = null;
+
+      // Port cleanup fallback
+      if (cleanupPort) {
+        const orphans = killOrphansByPort(cleanupPort);
+        if (orphans.length > 0) {
+          logEvent('WARN', name, `Killed orphan processes on port ${cleanupPort}: ${orphans.join(' ')}`);
+          await sleep(500);
+        }
+      }
+
+      if (stopping) break;
+
+      const runDuration = (Date.now() - startTime) / 1000;
+      if (runDuration >= 60) {
+        restartCount = 0;
+        logEvent('INFO', name, `Ran for ${Math.round(runDuration)}s, resetting restart counter`);
+      } else {
+        restartCount++;
+      }
+      if (restartCount >= MAX_RESTART_COUNT) {
+        logEvent('ERROR', name, `Max restart count (${MAX_RESTART_COUNT}) reached, giving up`);
+        break;
+      }
+
+      const delay = Math.min(RESTART_DELAY * (1 << Math.max(0, restartCount - 1)), MAX_DELAY);
+      logEvent('WARN', name, `Process exited with code ${exitCode}, restarting (${restartCount}/${MAX_RESTART_COUNT}) in ${delay}s...`);
+      await sleep(delay * 1000);
+    }
+
+    try { fs.closeSync(logFd); } catch {}
+  };
+
+  return run();
+}
+
+// ── Cleanup ───────────────────────────────────────────────────────────────────
+let cleanupDone = false;
+
+async function cleanup() {
+  if (cleanupDone) return;
+  cleanupDone = true;
+  stopping = true;
+
+  logEvent('INFO', 'main', 'Shutting down all processes...');
+
+  // Kill all managed process groups
+  for (const entry of managedProcesses) {
+    if (entry.pid) {
+      logEvent('INFO', 'main', `Stopping process group (PGID: ${entry.pid})`);
+      killProcessGroup(entry.pid, 'SIGTERM');
+    }
+  }
+
+  // Wait for graceful shutdown
+  await sleep(2000);
+
+  // Force kill any remaining
+  for (const entry of managedProcesses) {
+    if (entry.pid) {
+      logEvent('WARN', 'main', `Force killing process group (PGID: ${entry.pid})`);
+      killProcessGroup(entry.pid, 'SIGKILL');
+    }
+  }
+
+  // Port cleanup fallback
+  killOrphansByPort(SERVER_PORT);
+  killOrphansByPort(CLIENT_DEV_PORT);
+
+  logEvent('INFO', 'main', 'All processes stopped');
+
+  try { fs.closeSync(devStdLogFd); } catch {}
+  try { fs.closeSync(devLogFd); } catch {}
+
+  process.exit(0);
+}
+
+process.on('SIGTERM', cleanup);
+process.on('SIGINT', cleanup);
+process.on('SIGHUP', cleanup);
+
+// Stale dist makes nest --watch skip missing files; watcher won't self-heal.
+function cleanStaleDist() {
+  const distPath = path.join(PROJECT_ROOT, 'dist');
+  if (fs.existsSync(distPath)) {
+    fs.rmSync(distPath, { recursive: true, force: true });
+    logEvent('INFO', 'main', 'Cleaned dist/ to force full rebuild');
+  }
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+async function main() {
+  logEvent('INFO', 'main', '========== Dev session started ==========');
+
+  cleanStaleDist();
+
+  // Initialize action plugins
+  writeOutput('\n🔌 Initializing action plugins...\n');
+  try {
+    execSync('fullstack-cli action-plugin init', { cwd: PROJECT_ROOT, stdio: 'inherit' });
+    writeOutput('✅ Action plugins initialized\n\n');
+  } catch {
+    writeOutput('⚠️  Action plugin initialization failed, continuing anyway...\n\n');
+  }
+
+  // Start server and client
+  const serverPromise = startProcess({
+    name: 'server',
+    command: 'npm',
+    args: ['run', 'dev:server'],
+    cleanupPort: SERVER_PORT,
+  });
+
+  const clientPromise = startProcess({
+    name: 'client',
+    command: 'npm',
+    args: ['run', 'dev:client'],
+    cleanupPort: CLIENT_DEV_PORT,
+  });
+
+  writeOutput(`📋 Dev processes running. Press Ctrl+C to stop.\n`);
+  writeOutput(`📄 Logs: ${devStdLogPath}\n\n`);
+
+  // Wait for both (they loop until stopping or max restarts)
+  await Promise.all([serverPromise, clientPromise]);
+
+  if (!cleanupDone) {
+    await cleanup();
+  }
+}
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/template/scripts/dev.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+exec node "$(dirname "$0")/dev.js" "$@"