@fluxy-chat/create-fluxy-chat 0.5.9 → 0.5.13

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## [0.5.13] - 2026-08-27
+
+### Changed
+
+- Templates pin `@fluxy-chat/sdk@^0.6.4` (game `listLeaderboard`). Publish `@fluxy-chat/sdk@0.6.4` **before** this CLI, or `pnpm create` / StackBlitz will miss that version.
+
+## [0.5.12] - 2026-08-26
+
+### Added
+
+- Gallery `--example` apps: `live-cursors`, `live-cursors-chat`, `javascript-live-cursors`, `tiptap-room`, `whiteboard`, `draw`, `comments-board`, `war-room`, `iot-panel`, `deal-room`, `fleet-panel`, `game-tick`, `voice-stage`.
+
+### Changed
+
+- Templates that use React pin `@fluxy-chat/react@^0.1.4`. Publish `@fluxy-chat/protocol@0.1.5` and `@fluxy-chat/react@0.1.4` **before** this CLI, or `pnpm create` / StackBlitz will miss those versions.
+
+## [0.5.11] - 2026-08-25
+
+### Added
+
+- React and full templates expose `stopAgentStream` (Stop / Stop generation) while an agent reply is streaming. Comes from `@fluxy-chat/sdk@0.6.3` via `useChat`.
+
+### Changed
+
+- Templates pin `@fluxy-chat/sdk@^0.6.3`, `@fluxy-chat/react@^0.1.3`, `@fluxy-chat/ui@^0.1.4`, and `@fluxy-chat/ui-kit@^0.1.1` (minimal). Publish those packages **before** this CLI, or `pnpm create` will 404.
+
+## [0.5.10] - 2026-08-25
+
+### Added
+
+- Gold-path outro mentions `@assistant` in the generated React app.
+
+### Changed
+
+- Templates still depend on `@fluxy-chat/sdk@^0.6.2` (and `@fluxy-chat/react@^0.1.2` where used) so `pnpm create` works **before and after** sdk `0.6.3` is on npm. `^0.6.2` installs `0.6.3` once published.
+
 ## [0.5.9] - 2026-08-21
 
 ### Added

package/dist/index.js

@@ -875,6 +875,21 @@ 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";
+var GALLERY_EXAMPLES = [
+  "live-cursors",
+  "live-cursors-chat",
+  "javascript-live-cursors",
+  "tiptap-room",
+  "war-room",
+  "iot-panel",
+  "draw",
+  "deal-room",
+  "fleet-panel",
+  "game-tick",
+  "voice-stage",
+  "comments-board",
+  "whiteboard"
+];
 function parseArgs(argv) {
   const args = {
     yes: false,
@@ -896,6 +911,13 @@ function parseArgs(argv) {
     } else if (arg === "--full") {
       args.full = true;
       args.adapter = "full";
+    } else if (arg === "--example") {
+      const value = argv[++i]?.trim();
+      if (!value || !GALLERY_EXAMPLES.includes(value)) {
+        console.error(`Invalid example: ${value ?? ""}. Choose: ${GALLERY_EXAMPLES.join(", ")}`);
+        process.exit(1);
+      }
+      args.example = value;
     } else if (arg === "--mode") {
       const value = argv[++i]?.trim().toLowerCase();
       if (value === "local" || value === "hosted" || value === "self-host") {
@@ -975,6 +997,7 @@ ${pc.bold("Options:")}
                              hosted = Clerk on fluxychat.com (no wrangler)
                              local / self-host = your Worker (asks for URL + keys)
   --minimal                  Chat-only widget (ui-kit)
+  --example <name>           Gallery app: ${GALLERY_EXAMPLES.join(", ")}
   --skip-install             Skip dependency installation
   --no-git                   Skip git repository initialization
   -h, --help                 Show this help
@@ -982,6 +1005,10 @@ ${pc.bold("Options:")}
 ${pc.bold("Examples:")}
   ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-app --mode hosted -y")}
   ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-app --mode self-host")}
+  ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-cursors --example live-cursors")}
+  ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-doc --example tiptap-room")}
+  ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-war --example war-room")}
+  ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-iot --example iot-panel")}
   ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-chat --minimal")}
   ${pc.cyan("npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter slack")}
 `;
@@ -992,6 +1019,88 @@ async function main() {
     process.exit(0);
   }
   intro(pc.bgCyan(pc.black(" create-fluxy-chat ")));
+  if (args.example) {
+    const exampleName = args.example;
+    const projectName = args.name ?? `my-${exampleName}`;
+    const nameError = validateProjectName(projectName);
+    if (nameError) {
+      outro(pc.red(nameError));
+      process.exitCode = 1;
+      return;
+    }
+    const projectDir2 = path2.resolve(process.cwd(), projectName);
+    if (fs2.existsSync(projectDir2) && fs2.readdirSync(projectDir2).length > 0) {
+      outro(pc.red(`Directory "${projectName}" already exists and is not empty.`));
+      process.exitCode = 1;
+      return;
+    }
+    const s2 = spinner();
+    s2.start(`Copying example "${exampleName}"`);
+    const templateRoot = path2.join(templatesDir(), exampleName);
+    if (!fs2.existsSync(templateRoot)) {
+      s2.stop("Example template missing.");
+      outro(pc.red(`No template at ${templateRoot}`));
+      process.exitCode = 1;
+      return;
+    }
+    fs2.mkdirSync(projectDir2, { recursive: true });
+    copyDir(templateRoot, projectDir2);
+    const pkgPath = path2.join(projectDir2, "package.json");
+    const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf8"));
+    pkg.name = projectName;
+    writeJson(projectDir2, "package.json", pkg);
+    s2.stop(`Example "${exampleName}" created.`);
+    if (!args.noGit) {
+      const gitSpinner = spinner();
+      gitSpinner.start("Initializing git repository");
+      try {
+        await execAsync("git init", { cwd: projectDir2 });
+        gitSpinner.stop("Git repository initialized.");
+      } catch {
+        gitSpinner.stop("Failed to initialize git repository.");
+      }
+    }
+    if (!args.skipInstall) {
+      const pm2 = args.pm ?? detectPackageManager(process.env.npm_config_user_agent ?? "");
+      const installSpinner = spinner();
+      installSpinner.start(`Installing dependencies with ${pm2}`);
+      try {
+        await execAsync(installCommand(pm2), { cwd: projectDir2 });
+        installSpinner.stop("Dependencies installed.");
+      } catch {
+        installSpinner.stop("Failed to install dependencies.");
+        log.warning(`Run "${installCommand(pm2)}" manually in the project directory.`);
+      }
+    }
+    const pm = args.pm ?? detectPackageManager(process.env.npm_config_user_agent ?? "");
+    const devCmd2 = pm === "npm" ? "npm run" : pm;
+    const tryHints = {
+      "tiptap-room": "# Open two tabs \u2014 type in the editor",
+      "war-room": "# Open two tabs \u2014 chat; set AGENT_ID to invokeAgent",
+      "iot-panel": "# Keep this tab open; curl an ingest from another terminal",
+      draw: "# Open two tabs \u2014 move and click",
+      "deal-room": "# Open two tabs \u2014 propose a decision and ack from both",
+      "fleet-panel": "# Keep this tab open; click Post sample GPS",
+      "game-tick": "# Matchmake + start, then Submit input (not netcode)",
+      "voice-stage": "# Open two tabs \u2014 join speaker/listener (signaling, not WebRTC)",
+      "comments-board": "# Click the canvas to pin a thread",
+      "live-cursors-chat": "# Open two tabs \u2014 move and chat",
+      whiteboard: "# Open two tabs \u2014 draw strokes (Yjs, not a second CRDT)"
+    };
+    const tryHint = tryHints[exampleName] ?? "# Open two tabs \u2014 move the pointer";
+    note(
+      [
+        `cd ${projectName}`,
+        "cp .env.example .env",
+        "# Set VITE_FLUXYCHAT_WORKER_URL + public room ID or member JWT",
+        `${devCmd2} dev`,
+        tryHint
+      ].join("\n"),
+      "Next steps"
+    );
+    outro(`${pc.green("Done!")} Visit ${pc.cyan("https://docs.fluxychat.com/llms.txt")}`);
+    return;
+  }
   const config = await runPrompts({
     name: args.name,
     adapter: args.adapter,
@@ -1158,7 +1267,8 @@ async function main() {
     `cd ${config.name}`,
     "cp .env.example .env",
     "# Set VITE_FLUXYCHAT_WORKER_URL + JWT or public room ID",
-    `${devCmd} dev`
+    `${devCmd} dev`,
+    "# In the room, send: @assistant hello"
   ].join("\n") : [
     `cd ${config.name}`,
     "cp .env.example .dev.vars",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxy-chat/create-fluxy-chat",
-  "version": "0.5.9",
+  "version": "0.5.13",
   "description": "Scaffold a new FluxyChat bot project with a single command",
   "type": "module",
   "main": "./dist/index.js",

package/readme.md

@@ -26,6 +26,16 @@ Self-host writes `.fluxy/worker.dev.vars` (Worker URL, Groq key, signing key). M
 ```bash
 npx @fluxy-chat/create-fluxy-chat@latest my-app --mode hosted -y
 npx @fluxy-chat/create-fluxy-chat@latest my-app --full -y
+npx @fluxy-chat/create-fluxy-chat@latest my-cursors --example live-cursors
+npx @fluxy-chat/create-fluxy-chat@latest my-doc --example tiptap-room
+npx @fluxy-chat/create-fluxy-chat@latest my-war --example war-room
+npx @fluxy-chat/create-fluxy-chat@latest my-iot --example iot-panel
+npx @fluxy-chat/create-fluxy-chat@latest my-draw --example draw
+npx @fluxy-chat/create-fluxy-chat@latest my-deal --example deal-room
+npx @fluxy-chat/create-fluxy-chat@latest my-fleet --example fleet-panel
+npx @fluxy-chat/create-fluxy-chat@latest my-game --example game-tick
+npx @fluxy-chat/create-fluxy-chat@latest my-stage --example voice-stage
+npx @fluxy-chat/create-fluxy-chat@latest my-comments --example comments-board
 npx @fluxy-chat/create-fluxy-chat@latest my-chat --template react -y
 npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter slack --pm pnpm
 ```
@@ -41,6 +51,7 @@ npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter slack --pm pnpm
 | `--yes` | `-y` | Skip prompts and accept defaults |
 | `--full` | | Full stack template: chat + `@assistant` + `pnpm setup` / `pnpm dev` |
 | `--minimal` | | Chat-only widget (`@fluxy-chat/ui-kit`), no platform modules |
+| `--example <name>` | | Gallery: `live-cursors`, `live-cursors-chat`, `javascript-live-cursors`, `tiptap-room`, `war-room`, `iot-panel`, `draw`, `deal-room`, `fleet-panel`, `game-tick`, `voice-stage`, `comments-board`, `whiteboard` |
 | `--skip-install` | | Skip dependency installation |
 | `--no-git` | | Skip git repository initialization |
 | `--help` | `-h` | Show help |

package/templates/basic/package.json

@@ -9,7 +9,7 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@fluxy-chat/sdk": "^0.6.0"
+    "@fluxy-chat/sdk": "^0.6.4"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.0.0",

package/templates/comments-board/.env.example

@@ -0,0 +1,11 @@
+# FluxyChat worker URL (hosted or self-hosted)
+VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
+
+# Option A — member JWT
+VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
+VITE_FLUXYCHAT_ROOM_ID=demo
+# Optional — room-peer agent on the timeline
+# VITE_FLUXYCHAT_AGENT_ID=agt_...
+
+# Option B — public guest room
+# VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/comments-board/README.md

@@ -0,0 +1,9 @@
+# FluxyChat comments board
+
+Contextual `useThreads` pins — **not** chat `parentId` replies. Click the canvas to open `FloatingComposer`.
+
+```bash
+npx @fluxy-chat/create-fluxy-chat@latest my-comments --example comments-board
+cp .env.example .env
+npm run dev
+```

package/templates/comments-board/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 comments</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/comments-board/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "fluxy-comments-board",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@fluxy-chat/react": "^0.1.4",
+    "@fluxy-chat/sdk": "^0.6.4",
+    "@fluxy-chat/ui": "^0.1.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zustand": "^5.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/comments-board/src/App.tsx

@@ -0,0 +1,86 @@
+import { useState } from "react";
+import { FluxyRealtimeProvider, useChat, useThreads } from "@fluxy-chat/react";
+import { CommentPin, FloatingComposer, Thread } from "@fluxy-chat/ui";
+import { useFluxySession, workerUrl } from "./session";
+
+function CommentsBoard({ roomId }: { roomId: string }) {
+  const { threads, createThread, createComment, markThreadAsResolved, reload } = useThreads({ roomId });
+  const [draftPin, setDraftPin] = useState<{ x: number; y: number } | null>(null);
+  const [openId, setOpenId] = useState<string | null>(null);
+  useChat({
+    roomId,
+    replay: "off",
+    onServerEvent: (ev) => {
+      if (ev.name.startsWith("comment.")) void reload();
+    },
+  });
+
+  const openThread = threads.find((t) => t.id === openId) ?? null;
+
+  return (
+    <section className="panel">
+      <header className="chat-header">
+        <strong>Comments · {roomId}</strong>
+        <span className="status">pins + threads, not chat replies</span>
+      </header>
+      <div
+        className="canvas"
+        onClick={(event) => {
+          const rect = event.currentTarget.getBoundingClientRect();
+          setDraftPin({ x: event.clientX - rect.left, y: event.clientY - rect.top });
+        }}
+      >
+        {threads.map((thread) =>
+          thread.metadata.x != null && thread.metadata.y != null ? (
+            <CommentPin
+              key={thread.id}
+              x={thread.metadata.x}
+              y={thread.metadata.y}
+              count={thread.comments.length}
+              resolved={thread.resolved}
+              onClick={() => setOpenId(thread.id)}
+            />
+          ) : null,
+        )}
+        {draftPin ? (
+          <FloatingComposer
+            x={draftPin.x}
+            y={draftPin.y}
+            onCancel={() => setDraftPin(null)}
+            onSubmit={async (body) => {
+              const created = await createThread({ body, metadata: { x: draftPin.x, y: draftPin.y } });
+              setDraftPin(null);
+              if (created) setOpenId(created.id);
+            }}
+          />
+        ) : null}
+      </div>
+      {openThread ? (
+        <div style={{ padding: 12 }}>
+          <Thread
+            thread={openThread}
+            onReply={(body) => createComment(openThread.id, body)}
+            onResolve={(resolved) => markThreadAsResolved(openThread.id, resolved)}
+          />
+        </div>
+      ) : null}
+    </section>
+  );
+}
+
+export function App() {
+  const { session, loading, error } = useFluxySession();
+  if (!workerUrl) return <div className="shell">Set <code>VITE_FLUXYCHAT_WORKER_URL</code>.</div>;
+  if (loading) return <div className="shell">Starting…</div>;
+  if (error) return <div className="shell error">{error}</div>;
+  if (!session) return <div className="shell">Set a member JWT or public room id.</div>;
+
+  return (
+    <div className="shell">
+      <p className="mode-badge">{session.mode} · click the canvas to pin a thread</p>
+      <FluxyRealtimeProvider workerUrl={session.workerUrl} authTokenProvider={session.token} userId={session.userId}>
+        <CommentsBoard roomId={session.roomId} />
+      </FluxyRealtimeProvider>
+    </div>
+  );
+}

package/templates/comments-board/src/index.css

@@ -0,0 +1,75 @@
+:root {
+  font-family: system-ui, -apple-system, sans-serif;
+  line-height: 1.5;
+  color: #0f172a;
+  background: #f8fafc;
+}
+* { box-sizing: border-box; }
+body { margin: 0; }
+.shell { max-width: 720px; margin: 0 auto; padding: 1.5rem; }
+.panel {
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  overflow: hidden;
+  background: #fff;
+}
+.chat-header {
+  display: flex;
+  justify-content: space-between;
+  padding: 0.75rem 1rem;
+  background: #0f172a;
+  color: #fff;
+}
+.status { font-size: 0.75rem; opacity: 0.9; }
+.roster {
+  margin: 0;
+  padding: 0.5rem 1rem;
+  list-style: none;
+  font-size: 0.8rem;
+  color: #64748b;
+  border-bottom: 1px solid #e2e8f0;
+}
+.log { min-height: 240px; max-height: 50vh; overflow: auto; padding: 1rem; }
+.composer { display: flex; gap: 0.5rem; padding: 0.75rem; border-top: 1px solid #e2e8f0; }
+.composer input { flex: 1; padding: 0.5rem 0.75rem; border: 1px solid #cbd5e1; border-radius: 8px; }
+.composer button, button.primary {
+  padding: 0.5rem 0.75rem;
+  border: 0;
+  border-radius: 8px;
+  background: #2563eb;
+  color: #fff;
+  cursor: pointer;
+}
+.mode-badge { font-size: 0.75rem; color: #64748b; margin-bottom: 0.75rem; }
+.error { color: #b91c1c; }
+code { font-size: 0.85em; }
+.hint { font-size: 0.8rem; color: #475569; white-space: pre-wrap; background: #f1f5f9; padding: 0.75rem; border-radius: 8px; }
+.readings { margin: 0; padding: 0.75rem 1rem; list-style: none; font-size: 0.875rem; }
+.canvas {
+  position: relative;
+  height: min(70vh, 480px);
+  background: #f8fafc;
+  touch-action: none;
+}
+.dot {
+  position: absolute;
+  width: 10px;
+  height: 10px;
+  border-radius: 999px;
+  transform: translate(-50%, -50%);
+  pointer-events: none;
+}
+.peer-cursor {
+  position: absolute;
+  pointer-events: none;
+  z-index: 2;
+}
+.peer-cursor span {
+  display: block;
+  margin-top: 2px;
+  padding: 1px 6px;
+  border-radius: 4px;
+  background: currentColor;
+  color: #fff;
+  font-size: 11px;
+}

package/templates/comments-board/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { App } from "./App";
+import "./index.css";
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates/comments-board/src/session.ts

@@ -0,0 +1,73 @@
+import { useEffect, useState } from "react";
+import { FluxyChatClient } from "@fluxy-chat/sdk";
+
+const workerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL?.trim();
+const memberJwt = import.meta.env.VITE_FLUXYCHAT_MEMBER_JWT?.trim();
+const publicRoomId = import.meta.env.VITE_FLUXYCHAT_PUBLIC_ROOM_ID?.trim();
+const configuredRoomId = import.meta.env.VITE_FLUXYCHAT_ROOM_ID?.trim() || "demo";
+
+export interface FluxySession {
+  workerUrl: string;
+  token: string;
+  userId: string;
+  roomId: string;
+  mode: "member" | "guest";
+}
+
+export function useFluxySession(): {
+  session: FluxySession | null;
+  loading: boolean;
+  error: string | null;
+} {
+  const [session, setSession] = useState<FluxySession | null>(null);
+  const [loading, setLoading] = useState(Boolean(workerUrl));
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (!workerUrl) {
+      setLoading(false);
+      return;
+    }
+    if (memberJwt) {
+      setSession({
+        workerUrl,
+        token: memberJwt,
+        userId: "demo-user",
+        roomId: configuredRoomId,
+        mode: "member",
+      });
+      setLoading(false);
+      return;
+    }
+    if (publicRoomId) {
+      let cancelled = false;
+      void FluxyChatClient.joinPublicRoomAsGuest(workerUrl, publicRoomId, {
+        displayName: "Guest",
+      })
+        .then((guest) => {
+          if (cancelled) return;
+          setSession({
+            workerUrl,
+            token: guest.token,
+            userId: guest.userId,
+            roomId: guest.roomId,
+            mode: "guest",
+          });
+        })
+        .catch((err) => {
+          if (!cancelled) setError(err instanceof Error ? err.message : "Guest session failed");
+        })
+        .finally(() => {
+          if (!cancelled) setLoading(false);
+        });
+      return () => {
+        cancelled = true;
+      };
+    }
+    setLoading(false);
+  }, []);
+
+  return { session, loading, error };
+}
+
+export { workerUrl };

package/templates/comments-board/src/vite-env.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  readonly VITE_FLUXYCHAT_WORKER_URL: string;
+  readonly VITE_FLUXYCHAT_MEMBER_JWT?: string;
+  readonly VITE_FLUXYCHAT_ROOM_ID?: string;
+  readonly VITE_FLUXYCHAT_PUBLIC_ROOM_ID?: string;
+  readonly VITE_FLUXYCHAT_AGENT_ID?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/templates/comments-board/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}

package/templates/comments-board/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: { port: 5173 },
+});

package/templates/deal-room/.env.example

@@ -0,0 +1,11 @@
+# FluxyChat worker URL (hosted or self-hosted)
+VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
+
+# Option A — member JWT
+VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
+VITE_FLUXYCHAT_ROOM_ID=demo
+# Optional — room-peer agent on the timeline
+# VITE_FLUXYCHAT_AGENT_ID=agt_...
+
+# Option B — public guest room
+# VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/deal-room/README.md

@@ -0,0 +1,11 @@
+# FluxyChat deal room
+
+Chat + quorum decisions (`createDecision` / `ackDecision`) + Markdown export. Open **two tabs** and ack from both.
+
+Cross-org room linking is **server-side** REST (`/cross-org/...`), not MQTT and not this Vite app.
+
+```bash
+npx @fluxy-chat/create-fluxy-chat@latest my-deal --example deal-room
+cp .env.example .env
+npm run dev
+```

package/templates/deal-room/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 deal room</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/deal-room/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "fluxy-deal-room",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@fluxy-chat/react": "^0.1.4",
+    "@fluxy-chat/sdk": "^0.6.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "zustand": "^5.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"
+  }
+}