@fluxy-chat/create-fluxy-chat 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [0.5.0] - 2026-08-19
+
+### Added
+
+- `--full` / `--template full` — Vite app with realtime chat, `@assistant` invoke, and tool thread
+- `--mode hosted` — guest JWT via `GET /demo/session` (no local wrangler)
+- `--mode local` — provision against a local worker (`POST /dev/provision`)
+- Template scripts: `pnpm setup`, `pnpm setup:hosted`, `pnpm doctor`, `pnpm dev`
+- CLI next-steps link to `/onboarding?from=cli` (keep / import `.env`)
+
+### Changed
+
+- Interactive picker lists Full stack first
+- README hero documents hosted vs local paths

package/dist/index.js

@@ -15,6 +15,7 @@ import {
 // src/utils.ts
 import fs from "fs";
 import path from "path";
+import { fileURLToPath } from "url";
 var PACKAGE_NAME_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
 var PACKAGE_MANAGERS = /* @__PURE__ */ new Set(["npm", "yarn", "pnpm"]);
 function validateProjectName(value) {
@@ -30,7 +31,7 @@ function isPackageManager(value) {
   return PACKAGE_MANAGERS.has(value);
 }
 function isAdapterType(value) {
-  return ["basic", "slack", "telegram", "discord", "web", "react"].includes(value);
+  return ["basic", "slack", "telegram", "discord", "web", "react", "hr-feedback", "full"].includes(value);
 }
 function detectPackageManagerFromLockfiles(cwd) {
   if (fs.existsSync(path.join(cwd, "pnpm-lock.yaml"))) {
@@ -92,20 +93,19 @@ function copyDir(source, destination) {
   }
 }
 function templatesDir() {
-  return path.resolve(
-    path.dirname(new URL(import.meta.url).pathname.replace(/^\//, "")),
-    "..",
-    "templates"
-  );
+  return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "templates");
 }
 
 // src/prompts.ts
 var DEFAULT_PROJECT_NAME = "my-fluxy-bot";
+var DEFAULT_FULL_PROJECT_NAME = "my-fluxy-app";
 async function runPrompts(inputs) {
+  const full = inputs.full ?? inputs.adapter === "full";
+  const mode = inputs.mode ?? (full ? "local" : void 0);
   let name = inputs.name;
   if (!name) {
     if (inputs.yes) {
-      name = DEFAULT_PROJECT_NAME;
+      name = full ? DEFAULT_FULL_PROJECT_NAME : DEFAULT_PROJECT_NAME;
     } else {
       const result = await text({
         message: "Project name:",
@@ -122,15 +122,19 @@ async function runPrompts(inputs) {
   }
   const minimal = inputs.minimal ?? false;
   let adapter = inputs.adapter;
-  if (!minimal && !adapter) {
+  if (full) {
+    adapter = "full";
+  } else if (!minimal && !adapter) {
     if (inputs.yes) {
       adapter = "react";
     } else {
       const result = await select({
-        message: "Select an adapter:",
+        message: "Select a template:",
         options: [
-          { label: "Minimal chat widget (ui-kit, recommended)", value: "minimal" },
+          { label: "Full stack \u2014 chat + @assistant + setup (recommended)", value: "full" },
+          { label: "Minimal chat widget (ui-kit)", value: "minimal" },
           { label: "React chat app (Vite + useChat)", value: "react" },
+          { label: "HR anonymous feedback (compliance starter)", value: "hr-feedback" },
           { label: "Basic (Cloudflare Workers bot)", value: "basic" },
           { label: "Slack", value: "slack" },
           { label: "Telegram", value: "telegram" },
@@ -146,7 +150,8 @@ async function runPrompts(inputs) {
     }
   }
   let language = inputs.language;
-  if (!language) {
+  const isWorkerBot = !minimal && adapter !== "react" && adapter !== "full" && adapter !== "hr-feedback";
+  if (isWorkerBot && !language) {
     if (inputs.yes) {
       language = "typescript";
     } else {
@@ -160,6 +165,8 @@ async function runPrompts(inputs) {
       if (isCancel(result)) return null;
       language = result;
     }
+  } else if (!language) {
+    language = "typescript";
   }
   let packageManager = inputs.packageManager;
   if (!packageManager) {
@@ -194,10 +201,12 @@ async function runPrompts(inputs) {
     name,
     adapter: adapter ?? "react",
     packageManager,
-    language,
+    language: language ?? "typescript",
     shouldInstall,
     shouldInitGit,
-    minimal: minimal || inputs.minimal === true
+    minimal: minimal || inputs.minimal === true,
+    full: full || adapter === "full",
+    mode: mode ?? (adapter === "full" ? "local" : void 0)
   };
 }
 
@@ -798,10 +807,12 @@ import path2 from "path";
 import { exec } from "child_process";
 import { promisify } from "util";
 var execAsync = promisify(exec);
+var TEMPLATE_CHOICES = "react, full, basic, slack, telegram, discord, web, hr-feedback";
 function parseArgs(argv) {
   const args = {
     yes: false,
     minimal: false,
+    full: false,
     skipInstall: false,
     noGit: false,
     help: false
@@ -815,6 +826,21 @@ function parseArgs(argv) {
       args.yes = true;
     } else if (arg === "--minimal") {
       args.minimal = true;
+    } else if (arg === "--full") {
+      args.full = true;
+      args.adapter = "full";
+    } else if (arg === "--mode") {
+      const value = argv[++i]?.trim().toLowerCase();
+      if (value === "local" || value === "hosted") {
+        args.mode = value;
+        if (value === "hosted") {
+          args.full = true;
+          args.adapter = "full";
+        }
+      } else {
+        console.error(`Invalid mode: ${value}. Choose: local, hosted`);
+        process.exit(1);
+      }
     } else if (arg === "--skip-install") {
       args.skipInstall = true;
     } else if (arg === "--no-git") {
@@ -825,8 +851,10 @@ function parseArgs(argv) {
         args.adapter = value;
       } else if (value === "react") {
         args.adapter = "react";
+      } else if (value === "hr-feedback") {
+        args.adapter = "hr-feedback";
       } else {
-        console.error(`Invalid template: ${value}. Choose: react, basic, slack, telegram, discord, web`);
+        console.error(`Invalid template: ${value}. Choose: ${TEMPLATE_CHOICES}`);
         process.exit(1);
       }
     } else if (arg === "--adapter" || arg === "-a") {
@@ -834,7 +862,7 @@ function parseArgs(argv) {
       if (value && isAdapterType(value)) {
         args.adapter = value;
       } else {
-        console.error(`Invalid adapter: ${value}. Choose: react, basic, slack, telegram, discord, web`);
+        console.error(`Invalid adapter: ${value}. Choose: ${TEMPLATE_CHOICES}`);
         process.exit(1);
       }
     } else if (arg === "--pm" || arg === "--package-manager") {
@@ -872,18 +900,23 @@ ${pc.bold("Usage:")}
   npx create-fluxy-chat [project-name] [options]
 
 ${pc.bold("Options:")}
-  -a, --adapter <type>       Adapter: react, basic, slack, telegram, discord, web
-  -t, --template <type>      Alias for --adapter (e.g. react)
+  -a, --adapter <type>       Adapter: ${TEMPLATE_CHOICES}
+  -t, --template <type>      Alias for --adapter (e.g. full, react)
   --pm <manager>             Package manager: npm, pnpm, yarn
   -l, --language <lang>      Language: typescript (default) or javascript
   -y, --yes                  Skip prompts and accept defaults
+  --full                     Full stack: chat + @assistant + setup scripts (recommended)
+  --mode <local|hosted>      hosted = no wrangler (uses fluxychat.com demo session)
   --minimal                  Chat-only widget (ui-kit) \u2014 no platform modules
   --skip-install             Skip dependency installation
   --no-git                   Skip git repository initialization
   -h, --help                 Show this help
 
 ${pc.bold("Examples:")}
+  ${pc.cyan("npx create-fluxy-chat my-app --mode hosted -y")}
+  ${pc.cyan("npx create-fluxy-chat my-app --full -y")}
   ${pc.cyan("npx create-fluxy-chat my-chat --minimal")}
+  ${pc.cyan("npx create-fluxy-chat my-hr-bot --template hr-feedback")}
   ${pc.cyan("npx create-fluxy-chat my-chat --template react")}
   ${pc.cyan("npx create-fluxy-chat my-bot --adapter basic")}
   ${pc.cyan("npx create-fluxy-chat my-bot --adapter slack")}
@@ -904,6 +937,8 @@ async function main() {
     language: args.language,
     yes: args.yes,
     minimal: args.minimal,
+    full: args.full,
+    mode: args.mode,
     shouldInstall: args.skipInstall ? false : void 0,
     shouldInitGit: args.noGit ? false : void 0
   });
@@ -934,6 +969,26 @@ async function main() {
       pkg.name = config.name;
       writeJson(projectDir, "package.json", pkg);
       s.stop("Minimal chat widget created.");
+    } else if (config.full || config.adapter === "full") {
+      const templateRoot = path2.join(templatesDir(), "full");
+      copyDir(templateRoot, projectDir);
+      const pkgPath = path2.join(projectDir, "package.json");
+      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
+      pkg.name = config.name;
+      writeJson(projectDir, "package.json", pkg);
+      if (config.full || config.adapter === "full") {
+        fs2.mkdirSync(path2.join(projectDir, ".fluxy"), { recursive: true });
+        const setupMode = config.mode === "hosted" ? "hosted" : "local";
+        writeFile(
+          projectDir,
+          ".fluxy/mode",
+          `${setupMode}
+`
+        );
+      }
+      s.stop(
+        config.mode === "hosted" ? "Full stack app created (hosted mode \u2014 run pnpm setup:hosted)." : "Full stack app created (chat + agent + setup scripts)."
+      );
     } else if (config.adapter === "react") {
       const templateRoot = path2.join(templatesDir(), "react");
       copyDir(templateRoot, projectDir);
@@ -942,6 +997,14 @@ async function main() {
       pkg.name = config.name;
       writeJson(projectDir, "package.json", pkg);
       s.stop("React chat app created.");
+    } else if (config.adapter === "hr-feedback") {
+      const templateRoot = path2.join(templatesDir(), "hr-feedback");
+      copyDir(templateRoot, projectDir);
+      const pkgPath = path2.join(projectDir, "package.json");
+      const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
+      pkg.name = config.name;
+      writeJson(projectDir, "package.json", pkg);
+      s.stop("HR feedback starter created.");
     } else {
       writeJson(projectDir, "package.json", generatePackageJson(config));
       if (config.language === "typescript") {
@@ -989,18 +1052,31 @@ async function main() {
       );
     }
   }
-  note(
-    config.adapter === "react" ? [
-      `cd ${config.name}`,
-      "cp .env.example .env",
-      `${config.packageManager === "npm" ? "npm run" : config.packageManager} dev`
-    ].join("\n") : [
-      `cd ${config.name}`,
-      "cp .env.example .dev.vars",
-      `${config.packageManager === "npm" ? "npm run" : config.packageManager} dev`
-    ].join("\n"),
-    "Next steps"
-  );
+  const devCmd = config.packageManager === "npm" ? "npm run" : config.packageManager;
+  const nextSteps = config.full || config.adapter === "full" ? config.mode === "hosted" ? [
+    `cd ${config.name}`,
+    `${devCmd} setup:hosted   # guest JWT from fluxychat.com`,
+    `${devCmd} dev            # http://localhost:5173`,
+    `# Keep this project: https://fluxychat.com/onboarding?from=cli`
+  ].join("\n") : [
+    `# Terminal 1 \u2014 FluxyChat monorepo (if not already running)`,
+    `pnpm --filter @fluxy-chat/worker dev`,
+    ``,
+    `cd ${config.name}`,
+    `${devCmd} setup   # provision worker \u2192 writes .env`,
+    `${devCmd} dev     # http://localhost:5173 (+ dashboard if monorepo nearby)`,
+    `# Keep / import .env: http://localhost:3000/onboarding?from=cli`
+  ].join("\n") : config.adapter === "react" || config.minimal ? [
+    `cd ${config.name}`,
+    "cp .env.example .env",
+    "# Set VITE_FLUXYCHAT_WORKER_URL + JWT or public room ID",
+    `${devCmd} dev`
+  ].join("\n") : [
+    `cd ${config.name}`,
+    "cp .env.example .dev.vars",
+    `${devCmd} dev`
+  ].join("\n");
+  note(nextSteps, "Next steps");
   outro(
     `${pc.green("Done!")} Visit ${pc.cyan("https://github.com/AlessandroFare/fluxychat")} for the docs.`
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxy-chat/create-fluxy-chat",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Scaffold a new FluxyChat bot project with a single command",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,7 +13,8 @@
   "files": [
     "dist",
     "templates",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "dependencies": {
     "@clack/prompts": "^0.7.0",
@@ -38,7 +39,7 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts",
+    "build": "tsup src/index.ts --format esm",
     "dev": "tsup src/index.ts --format esm --watch",
     "typecheck": "tsc --noEmit"
   }

package/readme.md

@@ -5,19 +5,24 @@ Scaffold a new [FluxyChat](https://github.com/AlessandroFare/fluxychat) bot proj
 ## Quick start
 
 ```bash
-# Minimal chat widget (recommended — 3 lines in App.tsx)
+# Full stack — chat + @assistant + setup scripts (recommended)
+npx create-fluxy-chat my-app --full -y
+cd my-app && pnpm setup && pnpm dev
+
+# Minimal chat widget
 npx create-fluxy-chat my-chat --minimal
 
-# React + useChat (more control)
+# React + useChat only (bring your own worker URL)
 npx create-fluxy-chat my-chat --template react
 ```
 
-Interactive mode defaults to the **React chat app** template.
-
 ## Non-interactive usage
 
 ```bash
-# React + Vite + useChat (recommended)
+# Full stack (chat + agent + setup)
+npx create-fluxy-chat my-app --full -y
+
+# React + Vite + useChat
 npx create-fluxy-chat my-chat --template react -y
 
 # Create a Slack bot with pnpm
@@ -37,12 +42,13 @@ npx create-fluxy-chat my-bot --adapter basic
 
 | Flag | Short | Description |
 | --- | --- | --- |
-| `--adapter <type>` | `-a` | Adapter: `react`, `basic`, `slack`, `telegram`, `discord`, `web` |
-| `--template <type>` | `-t` | Alias for `--adapter (e.g. react)` |
+| `--adapter <type>` | `-a` | Adapter: `full`, `react`, `basic`, `slack`, `telegram`, `discord`, `web`, `hr-feedback` |
+| `--template <type>` | `-t` | Alias for `--adapter (e.g. full, react)` |
 | `--pm <manager>` | | Package manager: `npm`, `pnpm`, `yarn` |
 | `--language <lang>` | `-l` | Language: `typescript` (default) or `javascript` |
 | `--yes` | `-y` | Skip prompts and accept defaults |
-| `--minimal` | | Chat-only widget (`@fluxy-chat/ui-kit`) — no platform modules |
+| `--full` | | Full stack template: chat + `@assistant` + `pnpm setup` / `pnpm dev` |
+| `--minimal` | | Chat-only widget (`@fluxy-chat/ui-kit`), no platform modules |
 | `--skip-install` | | Skip dependency installation |
 | `--no-git` | | Skip git repository initialization |
 | `--help` | `-h` | Show help |
@@ -62,14 +68,14 @@ npx create-fluxy-chat my-bot --adapter basic
 
 Each generated project includes:
 
-- **`src/index.ts`** — Cloudflare Workers entry point with route handling
-- **`src/bot.ts`** — Bot handler using `@fluxy-chat/sdk`
-- **`fluxy.config.ts`** — Room authz and publish middleware (basic template)
-- **`wrangler.toml`** — Cloudflare Workers deployment config
-- **`.dev.vars`** — Local development environment variables
-- **`.env.example`** — Example environment variables for your adapter
-- **`tsconfig.json`** — TypeScript configuration (for TS projects)
-- **`README.md`** — Project-specific setup instructions
+- **`src/index.ts`**: Cloudflare Workers entry point with route handling
+- **`src/bot.ts`**: Bot handler using `@fluxy-chat/sdk`
+- **`fluxy.config.ts`**: Room authz and publish middleware (basic template)
+- **`wrangler.toml`**: Cloudflare Workers deployment config
+- **`.dev.vars`**: Local development environment variables
+- **`.env.example`**: Example environment variables for your adapter
+- **`tsconfig.json`**: TypeScript configuration (for TS projects)
+- **`README.md`**: Project-specific setup instructions
 
 ## Package manager detection
 

package/templates/full/.env.example

@@ -0,0 +1,10 @@
+# Generated by `pnpm setup` — or copy manually after onboarding / first-message.
+
+VITE_FLUXYCHAT_WORKER_URL=http://127.0.0.1:8787
+VITE_FLUXYCHAT_MEMBER_JWT=
+VITE_FLUXYCHAT_ROOM_ID=general
+VITE_FLUXYCHAT_AGENT_ID=
+VITE_FLUXYCHAT_AGENT_HANDLE=@assistant
+VITE_FLUXYCHAT_PROJECT_ID=
+VITE_FLUXYCHAT_CONSOLE_URL=http://localhost:3000
+VITE_FLUXYCHAT_USER_ID=demo-user

package/templates/full/README.md

@@ -0,0 +1,66 @@
+# FluxyChat — full stack starter
+
+Chat + AI agent + tool calls in one Vite app. Provisions against a local FluxyChat worker in ~60 seconds.
+
+## Quick start
+
+**Hosted (no wrangler):**
+
+```bash
+npx create-fluxy-chat my-app --mode hosted -y
+cd my-app
+pnpm install
+pnpm setup:hosted
+pnpm dev
+```
+
+**Local (full control):**
+
+```bash
+# Terminal 1 — monorepo worker
+pnpm --filter @fluxy-chat/worker dev
+
+# Terminal 2 — new project
+npx create-fluxy-chat my-app --full -y
+cd my-app
+pnpm install
+pnpm setup
+pnpm dev
+```
+
+Optional: `pnpm doctor` checks `.env`, worker health, room access.
+
+## What you get
+
+- Realtime chat (`useChat` + WebSocket)
+- `@assistant` invoke with tool call thread in the UI
+- Sidebar with project/room/agent metadata
+- Link to operator console
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `pnpm setup:hosted` | Guest JWT via `GET /demo/session` on api.fluxychat.com |
+| `pnpm setup:local` | Local `/dev/provision` (same as `pnpm setup`) |
+| `pnpm doctor` | Health check: .env, worker, room |
+| `pnpm dev` | Start Vite; auto-start worker if FluxyChat monorepo is detected nearby |
+| `pnpm dev:app` | Vite only |
+
+## Environment
+
+See `.env.example`. Generated by `pnpm setup`:
+
+- `VITE_FLUXYCHAT_WORKER_URL` — default `http://127.0.0.1:8787`
+- `VITE_FLUXYCHAT_MEMBER_JWT` — member token with admin roles
+- `VITE_FLUXYCHAT_ROOM_ID` — `{projectId}-general`
+- `VITE_FLUXYCHAT_AGENT_ID` — built-in `@assistant`
+
+## Hosted credentials
+
+Use [fluxychat.com/onboarding](https://fluxychat.com/onboarding) and copy values into `.env` manually.
+
+## Learn more
+
+- [One-click product roadmap](https://github.com/AlessandroFare/fluxychat/blob/main/docs/ONE-CLICK-PRODUCT-ROADMAP.md)
+- [Docs](https://docs.fluxychat.com)

package/templates/full/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>FluxyChat</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/full/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "fluxy-chat-full",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "setup": "node scripts/fluxy-setup.mjs",
+    "setup:hosted": "node scripts/fluxy-setup.mjs --mode hosted",
+    "setup:local": "node scripts/fluxy-setup.mjs --mode local",
+    "doctor": "node scripts/fluxy-doctor.mjs",
+    "dev": "node scripts/fluxy-dev.mjs",
+    "dev:app": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@fluxy-chat/react": "^0.1.1",
+    "@fluxy-chat/sdk": "^0.6.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "typescript": "^5.6.0",
+    "vite": "^6.0.0"
+  }
+}

package/templates/full/scripts/fluxy-dev.mjs

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+/**
+ * Start Vite app; optionally worker + dashboard from detected monorepo.
+ * Auto-runs setup when .env is missing and worker is reachable.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const envPath = join(root, ".env");
+const modePath = join(root, ".fluxy", "mode");
+const WORKER_URL = process.env.FLUXY_WORKER_URL || "http://127.0.0.1:8787";
+const POLL_MS = 500;
+const POLL_MAX = 90_000;
+const START_DASHBOARD = process.env.FLUXY_START_DASHBOARD !== "0";
+
+function findMonorepo(startDir) {
+  const explicit = process.env.FLUXYCHAT_ROOT?.trim();
+  if (explicit && existsSync(join(explicit, "apps", "worker", "package.json"))) {
+    return explicit;
+  }
+  let dir = startDir;
+  for (let i = 0; i < 10; i++) {
+    const workerPkg = join(dir, "apps", "worker", "package.json");
+    if (existsSync(workerPkg)) {
+      try {
+        const pkg = JSON.parse(readFileSync(workerPkg, "utf8"));
+        if (pkg.name === "@fluxy-chat/worker") return dir;
+      } catch {
+        /* ignore */
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function readSetupMode() {
+  if (existsSync(modePath)) {
+    const m = readFileSync(modePath, "utf8").trim().toLowerCase();
+    if (m === "hosted" || m === "local") return m;
+  }
+  return "local";
+}
+
+async function isWorkerUp(url = WORKER_URL) {
+  try {
+    const r = await fetch(`${url}/health`, { signal: AbortSignal.timeout(1500) });
+    return r.ok;
+  } catch {
+    return false;
+  }
+}
+
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function runProc(label, cmd, args, cwd, env = {}) {
+  const child = spawn(cmd, args, {
+    cwd,
+    shell: process.platform === "win32",
+    stdio: "inherit",
+    env: { ...process.env, ...env },
+  });
+  child.on("exit", (code) => {
+    if (code && code !== 0) {
+      console.error(`[${label}] exited with code ${code}`);
+    }
+  });
+  return child;
+}
+
+function runSetup(mode) {
+  const args = ["scripts/fluxy-setup.mjs"];
+  if (mode === "hosted") args.push("--mode", "hosted");
+  const result = spawnSync("node", args, {
+    cwd: root,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+  });
+  return result.status === 0;
+}
+
+async function main() {
+  const monorepo = findMonorepo(root);
+  const children = [];
+  const setupMode = readSetupMode();
+
+  if (!existsSync(envPath)) {
+    if (setupMode === "hosted") {
+      console.log("No .env — running hosted setup…");
+      if (!runSetup("hosted")) {
+        console.warn("Hosted setup failed. Fix network or run: pnpm setup -- --mode hosted");
+      }
+    } else if (await isWorkerUp()) {
+      console.log("No .env — running local setup…");
+      if (!runSetup("local")) {
+        console.warn("Setup failed. Run: pnpm setup");
+      }
+    } else if (monorepo) {
+      console.log("No .env — will start worker then run setup…");
+    } else {
+      console.warn(
+        "No .env found.\n" +
+          "  Hosted:  pnpm setup -- --mode hosted\n" +
+          "  Local:   start worker, then pnpm setup",
+      );
+    }
+  }
+
+  if (!(await isWorkerUp()) && setupMode === "local" && monorepo) {
+    console.log(`Starting worker from monorepo: ${monorepo}`);
+    children.push(
+      runProc("worker", "pnpm", ["--filter", "@fluxy-chat/worker", "dev"], monorepo, {
+        ALLOW_DEV_PROVISION: "true",
+        NODE_ENV: "development",
+      }),
+    );
+    const start = Date.now();
+    while (Date.now() - start < POLL_MAX) {
+      if (await isWorkerUp()) {
+        console.log(`Worker ready at ${WORKER_URL}`);
+        break;
+      }
+      await sleep(POLL_MS);
+    }
+    if (!existsSync(envPath) && (await isWorkerUp())) {
+      console.log("Running setup after worker start…");
+      runSetup("local");
+    }
+  } else if (await isWorkerUp()) {
+    console.log(`Worker reachable at ${WORKER_URL}`);
+  }
+
+  if (START_DASHBOARD && monorepo && setupMode === "local") {
+    console.log("Starting dashboard console on :3000");
+    children.push(
+      runProc("dashboard", "pnpm", ["--filter", "@fluxy-chat/dashboard", "dev"], monorepo),
+    );
+  }
+
+  children.push(runProc("vite", "pnpm", ["run", "dev:app"], root));
+
+  function shutdown() {
+    for (const child of children) {
+      if (child && !child.killed) {
+        try {
+          child.kill("SIGTERM");
+        } catch {
+          /* ignore */
+        }
+      }
+    }
+    process.exit(0);
+  }
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});