@fluxy-chat/create-fluxy-chat 0.5.14 → 0.5.19

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.5.19] - 2026-09-02
+
+### Added
+
+- Full template `fluxy.hosted.json` deploys `rooms` templates and extension slots with `pnpm fluxy:deploy`.
+- Pin `@fluxy-chat/sdk@^0.6.8` (`connectInbox`, room extensions).
+
+## [0.5.18] - 2026-09-01
+
+### Added
+
+- Hosted `setup:hosted` reads `GET /public/demo-credentials` and writes `VITE_FLUXYCHAT_PUBLISHABLE_KEY`.
+- `pnpm fluxy:deploy` on the full template: `fluxy.hosted.json` → `PUT /admin/projects/:id/publish-config`.
+- React and live-cursors templates prefer `publishableKey` (pin sdk `^0.6.7` / react `^0.1.6`).
+
+## [0.5.17] - 2026-09-01
+
+### Added
+
+- Gallery `--example polls`: `createPoll` / `votePoll`. Prefers `VITE_FLUXYCHAT_PUBLISHABLE_KEY`. Documents `POST /polls` `isAnonymous`.
+
+## [0.5.16] - 2026-08-31
+
+### Added
+
+- `deal-room` template: Ask agent when `VITE_FLUXYCHAT_AGENT_ID` is set (`invokeAgent`).
+
+## [0.5.15] - 2026-08-31
+
+### Changed
+
+- Help text states the scoped package: `npx @fluxy-chat/create-fluxy-chat@latest`. Unscoped `create-fluxy-chat` is not ours.
+
 ## [0.5.14] - 2026-08-27
 
 ### Changed

package/dist/index.js

@@ -888,6 +888,7 @@ var GALLERY_EXAMPLES = [
   "game-tick",
   "voice-stage",
   "comments-board",
+  "polls",
   "whiteboard"
 ];
 function parseArgs(argv) {
@@ -983,6 +984,9 @@ function parseArgs(argv) {
 var HELP_TEXT = `
 ${pc.bold("create-fluxy-chat")} \u2014 Scaffold a FluxyChat app or bot worker
 
+${pc.yellow("Use the scoped package:")} npx @fluxy-chat/create-fluxy-chat@latest
+Unscoped ${pc.bold("npx create-fluxy-chat")} is not ours and will 404.
+
 ${pc.bold("Usage:")}
   npx @fluxy-chat/create-fluxy-chat [project-name] [options]
 
@@ -1008,7 +1012,7 @@ ${pc.bold("Examples:")}
   ${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-polls --example polls")}
   ${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")}
 `;
@@ -1084,6 +1088,7 @@ async function main() {
       "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",
+      polls: "# Create a poll, open a second tab, vote",
       "live-cursors-chat": "# Open two tabs \u2014 move and chat",
       whiteboard: "# Open two tabs \u2014 draw strokes (Yjs, not a second CRDT)"
     };
@@ -1092,7 +1097,7 @@ async function main() {
       [
         `cd ${projectName}`,
         "cp .env.example .env",
-        "# Set VITE_FLUXYCHAT_WORKER_URL + public room ID or member JWT",
+        "# Set VITE_FLUXYCHAT_WORKER_URL + pk_ (or public room ID / member JWT)",
         `${devCmd2} dev`,
         tryHint
       ].join("\n"),
@@ -1253,7 +1258,7 @@ async function main() {
   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} setup:hosted   # writes pk_ when /public/demo-credentials is on`,
     `${devCmd} dev            # http://localhost:5173`,
     `# Keep this project: https://fluxychat.com/onboarding?from=cli`
   ].join("\n") : [
@@ -1266,7 +1271,7 @@ async function main() {
   ].join("\n") : config.adapter === "react" || config.minimal ? [
     `cd ${config.name}`,
     "cp .env.example .env",
-    "# Set VITE_FLUXYCHAT_WORKER_URL + JWT or public room ID",
+    "# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_PUBLISHABLE_KEY",
     `${devCmd} dev`,
     "# In the room, send: @assistant hello"
   ].join("\n") : [

package/package.json

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

package/readme.md

@@ -36,6 +36,7 @@ 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-polls --example polls
 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
 ```
@@ -51,7 +52,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` |
+| `--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`, `polls`, `whiteboard` |
 | `--skip-install` | | Skip dependency installation |
 | `--no-git` | | Skip git repository initialization |
 | `--help` | `-h` | Show help |

package/templates/deal-room/src/App.tsx

@@ -4,9 +4,10 @@ import { useFluxySession, workerUrl } from "./session";
 
 function DealBoard({ roomId }: { roomId: string }) {
   const { client } = useFluxyChat();
-  const { messages, sendMessage, connected } = useChat({ roomId, replay: "request" });
+  const { messages, sendMessage, connected, invokeAgent } = useChat({ roomId, replay: "request" });
   const [draft, setDraft] = useState("Approve term sheet?");
   const [busy, setBusy] = useState(false);
+  const agentId = import.meta.env.VITE_FLUXYCHAT_AGENT_ID?.trim();
 
   async function propose() {
     const content = draft.trim();
@@ -45,6 +46,16 @@ function DealBoard({ roomId }: { roomId: string }) {
     URL.revokeObjectURL(url);
   }
 
+  async function askAgent() {
+    if (!agentId) return;
+    setBusy(true);
+    try {
+      await invokeAgent(agentId, "Summarize this deal thread and list open decisions.");
+    } finally {
+      setBusy(false);
+    }
+  }
+
   return (
     <section className="panel">
       <header className="chat-header">
@@ -87,6 +98,11 @@ function DealBoard({ roomId }: { roomId: string }) {
         <button type="button" className="primary" onClick={() => void exportMarkdown()}>
           Export .md
         </button>
+        {agentId ? (
+          <button type="button" disabled={busy} onClick={() => void askAgent()}>
+            Ask agent
+          </button>
+        ) : null}
       </form>
     </section>
   );

package/templates/full/README.md

@@ -1,6 +1,6 @@
 # FluxyChat full stack starter
 
-Chat + AI agent in a Vite app. Hosted mode starts with a short local tour, then Clerk, then your own room.
+Chat + AI agent in a Vite app. Hosted: `pnpm setup:hosted` writes a public `pk_` when the Worker exposes `GET /public/demo-credentials`. Otherwise copy a `pk_` from the console, or sign in for a private assistant room.
 
 ## Quick start
 
@@ -14,7 +14,16 @@ pnpm setup:hosted
 pnpm dev
 ```
 
-Localhost opens a 3-step tour. Last step is sign in. After Clerk you come back to a simple chat. Open a second tab to try realtime. Use Open dashboard for rooms and agents.
+If demo credentials are configured on the Worker, chat starts with `publishableKey` (no Clerk). Sign in later for a private assistant room.
+
+**Hosted overlay (one file deploy for deny / rooms / extension slots):**
+
+```bash
+# fluxy.hosted.json → PUT /admin/projects/:id/publish-config
+FLUXY_WORKER_URL=https://api.fluxychat.com FLUXY_ADMIN_JWT=eyJ... FLUXY_PROJECT_ID=prj_... pnpm fluxy:deploy
+```
+
+This is not Worker-bundled `onPublish` callbacks. Those run in `fluxy.config.ts` on self-host. Hosted extension slots are declared `kv` / `counter` on the room Durable Object (`GET /rooms/:id/extensions`).
 
 **Self-host (your Worker):**
 
@@ -37,14 +46,15 @@ If the Worker is down, `setup:local` asks for the URL. Merge `.fluxy/worker.dev.
 
 | Command | Description |
 |---------|-------------|
-| `pnpm setup:hosted` | Writes worker + console URLs. Auth happens in the browser via Clerk. |
+| `pnpm setup:hosted` | Worker URL + public `pk_` when `/public/demo-credentials` is configured |
+| `pnpm fluxy:deploy` | PUT hosted publish-config from `fluxy.hosted.json` |
 | `pnpm setup:local` / `pnpm setup:self-host` | `POST /dev/provision` on your Worker |
 | `pnpm doctor` | Health check |
 | `pnpm dev` | Start Vite |
 
 ## Environment
 
-`.env` from `pnpm setup:hosted` only needs worker and console URLs. Member JWT, room, and agent come from Clerk after sign in.
+`.env` from `pnpm setup:hosted` includes worker URL and, when configured, `VITE_FLUXYCHAT_PUBLISHABLE_KEY`. Clerk still creates a private assistant room.
 
 Dashboard: [fluxychat.com/dashboard](https://fluxychat.com/dashboard)
 

package/templates/full/fluxy.hosted.json

@@ -0,0 +1,15 @@
+{
+  "denySubstrings": [],
+  "guestCanPublish": true,
+  "iotAutoAgentId": null,
+  "rooms": {
+    "support-*": {
+      "anonymous": false,
+      "guestCanPublish": false
+    },
+    "room-*": {
+      "anonymous": true,
+      "extensions": [{ "id": "state", "kind": "kv" }]
+    }
+  }
+}

package/templates/full/package.json

@@ -8,6 +8,7 @@
     "setup:hosted": "node scripts/fluxy-setup.mjs --mode hosted",
     "setup:local": "node scripts/fluxy-setup.mjs --mode local",
     "setup:self-host": "node scripts/fluxy-setup.mjs --mode self-host",
+    "fluxy:deploy": "node scripts/fluxy-deploy.mjs",
     "doctor": "node scripts/fluxy-doctor.mjs",
     "dev": "node scripts/fluxy-dev.mjs",
     "dev:app": "vite",
@@ -16,8 +17,8 @@
     "postinstall": "node scripts/hoist-fluxy-sdk.mjs"
   },
   "dependencies": {
-    "@fluxy-chat/react": "^0.1.4",
-    "@fluxy-chat/sdk": "^0.6.5",
+    "@fluxy-chat/react": "^0.1.6",
+    "@fluxy-chat/sdk": "^0.6.8",
     "@fluxy-chat/ui": "^0.1.4",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -40,7 +41,7 @@
   },
   "pnpm": {
     "overrides": {
-      "@fluxy-chat/sdk": "^0.6.5"
+      "@fluxy-chat/sdk": "^0.6.8"
     }
   }
 }

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

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Hosted overlay: PUT /admin/projects/:id/publish-config
+ * Serializes one fluxy.hosted.json (deny, guest publish, iotAutoAgentId, rooms
+ * templates + extension slots). Does not upload Worker callbacks.
+ *
+ *   FLUXY_WORKER_URL=https://api.fluxychat.com \
+ *   FLUXY_ADMIN_JWT=eyJ... \
+ *   FLUXY_PROJECT_ID=prj_... \
+ *   pnpm fluxy:deploy
+ */
+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 configPath = join(root, "fluxy.hosted.json");
+
+const workerUrl = (process.env.FLUXY_WORKER_URL || process.env.VITE_FLUXYCHAT_WORKER_URL || "").replace(/\/$/, "");
+const adminJwt = process.env.FLUXY_ADMIN_JWT || "";
+const projectId = process.env.FLUXY_PROJECT_ID || process.env.VITE_FLUXYCHAT_PROJECT_ID || "";
+
+function fail(msg) {
+  console.error(`fluxy deploy: ${msg}`);
+  process.exit(1);
+}
+
+if (!workerUrl) fail("set FLUXY_WORKER_URL");
+if (!adminJwt) fail("set FLUXY_ADMIN_JWT (owner/admin JWT, not pk_)");
+if (!projectId) fail("set FLUXY_PROJECT_ID");
+if (!existsSync(configPath)) fail(`missing ${configPath}`);
+
+const hosted = JSON.parse(readFileSync(configPath, "utf8"));
+const body = {
+  denySubstrings: Array.isArray(hosted.denySubstrings) ? hosted.denySubstrings : [],
+  guestCanPublish: hosted.guestCanPublish !== false,
+  iotAutoAgentId: hosted.iotAutoAgentId ?? null,
+  rooms: hosted.rooms && typeof hosted.rooms === "object" ? hosted.rooms : {},
+};
+
+const url = `${workerUrl}/admin/projects/${encodeURIComponent(projectId)}/publish-config`;
+const res = await fetch(url, {
+  method: "PUT",
+  headers: {
+    Authorization: `Bearer ${adminJwt}`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify(body),
+});
+const text = await res.text();
+if (!res.ok) fail(`${res.status} ${text}`);
+console.log("publish-config updated");
+console.log(text);

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

@@ -194,6 +194,7 @@ function writeEnv(vars) {
   const lines = [
     "# Auto-generated by pnpm setup — do not commit secrets",
     `VITE_FLUXYCHAT_WORKER_URL=${vars.workerUrl}`,
+    `VITE_FLUXYCHAT_PUBLISHABLE_KEY=${vars.publishableKey || ""}`,
     `VITE_FLUXYCHAT_MEMBER_JWT=${vars.token}`,
     `VITE_FLUXYCHAT_ROOM_ID=${vars.roomId}`,
     `VITE_FLUXYCHAT_AGENT_ID=${vars.agentId}`,
@@ -218,13 +219,30 @@ async function setupHosted() {
     process.env.FLUXY_WORKER_URL ||
     HOSTED_WORKER_DEFAULT;
   const consoleUrl = process.env.FLUXY_CONSOLE_URL || HOSTED_CONSOLE_DEFAULT;
+  const fromEnvPk = (process.env.FLUXY_PUBLISHABLE_KEY || process.env.VITE_FLUXYCHAT_PUBLISHABLE_KEY || "").trim();
 
   console.log(dim(`  mode: hosted · worker: ${workerUrl}`));
 
+  let publishableKey = fromEnvPk.startsWith("pk_") ? fromEnvPk : "";
+  let roomId = process.env.VITE_FLUXYCHAT_ROOM_ID?.trim() || "";
+  if (!publishableKey) {
+    try {
+      const demo = await getJson(workerUrl, "/public/demo-credentials");
+      if (demo?.publishableKey?.startsWith("pk_")) {
+        publishableKey = demo.publishableKey;
+        roomId = demo.roomId || roomId || "general";
+        ok("wrote public demo pk_ (GET /public/demo-credentials)");
+      }
+    } catch {
+      /* demo not configured on this Worker */
+    }
+  }
+
   writeEnv({
     workerUrl,
+    publishableKey,
     token: "",
-    roomId: "",
+    roomId: roomId || (publishableKey ? "general" : ""),
     agentId: "",
     agentHandle: "@assistant",
     projectId: "",
@@ -236,17 +254,22 @@ async function setupHosted() {
     mode: "hosted",
     workerUrl,
     projectId: null,
-    roomId: null,
+    roomId: roomId || null,
     agentId: null,
     agentHandle: "@assistant",
     setupAt: new Date().toISOString(),
-    auth: "clerk",
+    auth: publishableKey ? "publishableKey" : "clerk",
   });
 
-  ok("wrote hosted endpoints (sign in with Clerk on pnpm dev)");
-  console.log(dim("  Run: pnpm dev"));
-  console.log(dim("  Sign in with Clerk. We create your project and assistant room."));
-  console.log(dim(`  Console: ${consoleUrl}/onboarding`));
+  if (publishableKey) {
+    ok("public room is ready. pnpm dev — no Clerk required");
+    console.log(dim("  Sign in later for a private assistant room: Open dashboard"));
+  } else {
+    ok("wrote hosted endpoints (copy a pk_ from the console, or sign in on pnpm dev)");
+    console.log(dim("  Run: pnpm dev"));
+    console.log(dim(`  Console: ${consoleUrl}/onboarding`));
+    console.log(dim("  Hosted ops: set PUBLIC_DEMO_PUBLISHABLE_KEY on the Worker for a no-account path"));
+  }
 }
 
 async function setupLocal() {
@@ -323,6 +346,7 @@ async function setupLocal() {
 
   writeEnv({
     workerUrl,
+    publishableKey: provision.publishableKey || "",
     token: auth.token,
     roomId,
     agentId: agent.id,

package/templates/full/src/App.tsx

@@ -4,6 +4,7 @@ import { ChatWindow } from "@fluxy-chat/ui";
 import { loadCliSession, type CliSession } from "./session";
 
 const envWorkerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL?.trim() ?? "";
+const envPublishableKey = import.meta.env.VITE_FLUXYCHAT_PUBLISHABLE_KEY?.trim() ?? "";
 const envJwt = import.meta.env.VITE_FLUXYCHAT_MEMBER_JWT?.trim() ?? "";
 const envRoomId = import.meta.env.VITE_FLUXYCHAT_ROOM_ID?.trim() ?? "";
 const envAgentId = import.meta.env.VITE_FLUXYCHAT_AGENT_ID?.trim() ?? "";
@@ -31,6 +32,18 @@ function dashboardHref(): string {
 }
 
 function sessionFromEnv(): CliSession | null {
+  if (envWorkerUrl && envPublishableKey.startsWith("pk_") && envRoomId) {
+    return {
+      workerUrl: envWorkerUrl,
+      publishableKey: envPublishableKey,
+      memberJwt: envJwt || undefined,
+      roomId: envRoomId,
+      agentId: envAgentId,
+      agentHandle: envAgentHandle,
+      projectId: envProjectId,
+      userId: envUserId || "guest",
+    };
+  }
   if (!envWorkerUrl || !envJwt || !envRoomId) return null;
   return {
     workerUrl: envWorkerUrl,
@@ -226,6 +239,7 @@ export function App() {
       <div className="page">
         <FluxyRealtimeProvider
           workerUrl={session.workerUrl}
+          publishableKey={session.memberJwt ? undefined : session.publishableKey}
           authTokenProvider={session.memberJwt}
           userId={session.userId}
         >

package/templates/full/src/session.ts

@@ -2,7 +2,8 @@ const STORAGE_KEY = "fluxy-cli-session";
 
 export interface CliSession {
   workerUrl: string;
-  memberJwt: string;
+  memberJwt?: string;
+  publishableKey?: string;
   roomId: string;
   agentId: string;
   agentHandle: string;
@@ -15,7 +16,11 @@ export interface CliSession {
 function isCliSession(value: unknown): value is CliSession {
   if (!value || typeof value !== "object") return false;
   const v = value as Record<string, unknown>;
-  return typeof v.memberJwt === "string" && v.memberJwt.length > 0 && typeof v.workerUrl === "string";
+  if (typeof v.workerUrl !== "string" || v.workerUrl.length === 0) return false;
+  if (typeof v.roomId !== "string" || v.roomId.length === 0) return false;
+  const hasMember = typeof v.memberJwt === "string" && v.memberJwt.length > 0;
+  const hasPk = typeof v.publishableKey === "string" && v.publishableKey.startsWith("pk_");
+  return hasMember || hasPk;
 }
 
 export function readCliSessionFromHash(): CliSession | null {

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

@@ -2,7 +2,8 @@
 
 interface ImportMetaEnv {
   readonly VITE_FLUXYCHAT_WORKER_URL: string;
-  readonly VITE_FLUXYCHAT_MEMBER_JWT: string;
+  readonly VITE_FLUXYCHAT_PUBLISHABLE_KEY?: string;
+  readonly VITE_FLUXYCHAT_MEMBER_JWT?: string;
   readonly VITE_FLUXYCHAT_ROOM_ID: string;
   readonly VITE_FLUXYCHAT_AGENT_ID: string;
   readonly VITE_FLUXYCHAT_AGENT_HANDLE: string;

package/templates/live-cursors/.env.example

@@ -1,9 +1,12 @@
 # FluxyChat worker URL (hosted or self-hosted)
-VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
+VITE_FLUXYCHAT_WORKER_URL=https://api.fluxychat.com
 
-# Option A — member JWT (~2 min via onboarding)
-VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
-VITE_FLUXYCHAT_ROOM_ID=demo
+# Option A — public room (pin sdk 0.6.7+)
+VITE_FLUXYCHAT_PUBLISHABLE_KEY=pk_...
+VITE_FLUXYCHAT_ROOM_ID=general
 
-# Option B — public guest room (~60s, no signup)
+# Option B — member JWT
+# VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
+
+# Option C — guest session without pk_
 # VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/live-cursors/package.json

@@ -9,8 +9,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fluxy-chat/react": "^0.1.4",
-    "@fluxy-chat/sdk": "^0.6.5",
+    "@fluxy-chat/react": "^0.1.6",
+    "@fluxy-chat/sdk": "^0.6.7",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zustand": "^5.0.0"

package/templates/live-cursors/src/App.tsx

@@ -3,6 +3,7 @@ import { FluxyChatClient } from "@fluxy-chat/sdk";
 import { FluxyRealtimeProvider, useChat } from "@fluxy-chat/react";
 
 const workerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL?.trim();
+const publishableKey = import.meta.env.VITE_FLUXYCHAT_PUBLISHABLE_KEY?.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";
@@ -149,6 +150,23 @@ function hashCode(value: string): number {
 }
 
 export function App() {
+  const pkRoomId = publicRoomId || configuredRoomId;
+  if (workerUrl && publishableKey) {
+    return (
+      <main className="shell">
+        <h1>Live cursors</h1>
+        <p className="mode-badge">publishableKey · two tabs, same room</p>
+        <FluxyRealtimeProvider workerUrl={workerUrl} publishableKey={publishableKey}>
+          <CursorCanvas roomId={pkRoomId} selfUserId="guest" />
+        </FluxyRealtimeProvider>
+      </main>
+    );
+  }
+
+  return <MemberOrGuestCursors />;
+}
+
+function MemberOrGuestCursors() {
   const { session, loading, error } = useFluxySession();
   const [roomId, setRoomId] = useState(configuredRoomId);
 
@@ -166,8 +184,7 @@ export function App() {
           <code>VITE_FLUXYCHAT_WORKER_URL</code>.
         </p>
         <p>
-          Then either <code>VITE_FLUXYCHAT_MEMBER_JWT</code> or{" "}
-          <code>VITE_FLUXYCHAT_PUBLIC_ROOM_ID</code>.
+          Then <code>VITE_FLUXYCHAT_PUBLISHABLE_KEY</code>, a member JWT, or a public room id.
         </p>
       </main>
     );

package/templates/live-cursors/src/vite-env.d.ts

@@ -2,6 +2,7 @@
 
 interface ImportMetaEnv {
   readonly VITE_FLUXYCHAT_WORKER_URL: string;
+  readonly VITE_FLUXYCHAT_PUBLISHABLE_KEY?: string;
   readonly VITE_FLUXYCHAT_MEMBER_JWT?: string;
   readonly VITE_FLUXYCHAT_ROOM_ID?: string;
   readonly VITE_FLUXYCHAT_PUBLIC_ROOM_ID?: string;

package/templates/minimal/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fluxy-chat/ui-kit": "^0.1.3",
+    "@fluxy-chat/ui-kit": "^0.1.4",
     "@fluxy-chat/ui": "^0.1.4",
     "@fluxy-chat/react": "^0.1.4",
     "@fluxy-chat/sdk": "^0.6.5",

package/templates/polls/.env.example

@@ -0,0 +1,13 @@
+# FluxyChat worker URL (hosted or self-hosted)
+VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
+
+# Option A — public room, no member JWT (pin sdk 0.6.7+)
+VITE_FLUXYCHAT_PUBLISHABLE_KEY=pk_...
+VITE_FLUXYCHAT_ROOM_ID=your-public-room-id
+
+# Option B — member JWT
+# VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
+# VITE_FLUXYCHAT_ROOM_ID=demo
+
+# Option C — public guest session without pk_
+# VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/polls/README.md

@@ -0,0 +1,13 @@
+# FluxyChat polls
+
+First-class room polls: `createPoll` / `votePoll` on the chat timeline.
+
+Anonymous ballots (voter ids omitted from results) are a separate HTTP path: `POST /polls` with `isAnonymous: true`, then `POST /polls/:id/close`. That is not `createPoll`.
+
+```bash
+npx @fluxy-chat/create-fluxy-chat@latest my-polls --example polls
+cp .env.example .env
+npm run dev
+```
+
+Fastest path: `VITE_FLUXYCHAT_WORKER_URL` + `VITE_FLUXYCHAT_PUBLISHABLE_KEY` (`pk_`) + a public room id. Pin `@fluxy-chat/sdk@0.6.7` and `@fluxy-chat/react@0.1.6` once those versions are on npm.

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

package/templates/polls/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "fluxy-polls",
+  "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.6",
+    "@fluxy-chat/sdk": "^0.6.7",
+    "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/polls/src/App.tsx

@@ -0,0 +1,135 @@
+import { useState } from "react";
+import {
+  FluxyRealtimeProvider,
+  useChat,
+  useFluxyChat,
+} from "@fluxy-chat/react";
+import { useFluxySession, workerUrl } from "./session";
+
+const publishableKey = import.meta.env.VITE_FLUXYCHAT_PUBLISHABLE_KEY?.trim();
+const pkRoomId =
+  import.meta.env.VITE_FLUXYCHAT_ROOM_ID?.trim() ||
+  import.meta.env.VITE_FLUXYCHAT_PUBLIC_ROOM_ID?.trim() ||
+  "demo";
+
+function PollRoom({ roomId }: { roomId: string }) {
+  const { client } = useFluxyChat();
+  const { messages } = useChat({ roomId });
+  const [question, setQuestion] = useState("Ship Friday?");
+  const [error, setError] = useState<string | null>(null);
+
+  async function createTimelinePoll() {
+    setError(null);
+    try {
+      await client.createPoll(roomId, {
+        question,
+        options: ["Yes", "No", "Abstain"],
+      });
+    } catch (err) {
+      setError(err instanceof Error ? err.message : "createPoll failed");
+    }
+  }
+
+  return (
+    <section className="panel">
+      <header className="chat-header">
+        <strong>Polls · {roomId}</strong>
+        <span className="status">createPoll / votePoll on the timeline</span>
+      </header>
+      <div className="composer">
+        <input
+          value={question}
+          onChange={(event) => setQuestion(event.target.value)}
+          placeholder="Question"
+        />
+        <button type="button" className="primary" onClick={() => void createTimelinePoll()}>
+          Create poll
+        </button>
+      </div>
+      {error ? <p className="error" style={{ padding: "0 1rem" }}>{error}</p> : null}
+      <ul className="log">
+        {messages.map((message) => (
+          <li key={message.id} className="poll-card">
+            {message.poll ? (
+              <>
+                <p>
+                  <strong>{message.poll.question}</strong>
+                  {message.poll.closed ? " · closed" : ""}
+                </p>
+                <div className="poll-options">
+                  {message.poll.options.map((option) => (
+                    <button
+                      key={option.index}
+                      type="button"
+                      disabled={message.poll?.closed}
+                      onClick={() => void client.votePoll(message.id, option.index)}
+                    >
+                      {option.text} · {option.votes}
+                    </button>
+                  ))}
+                </div>
+                <p className="hint" style={{ marginTop: 8 }}>
+                  {message.poll.totalVoters} voters
+                  {message.poll.userVote != null ? ` · you voted ${message.poll.userVote}` : ""}
+                </p>
+              </>
+            ) : (
+              <p>
+                <strong>{message.userId}</strong> {message.content}
+              </p>
+            )}
+          </li>
+        ))}
+      </ul>
+    </section>
+  );
+}
+
+export function App() {
+  if (!workerUrl) return <div className="shell">Set <code>VITE_FLUXYCHAT_WORKER_URL</code>.</div>;
+
+  if (publishableKey) {
+    return (
+      <div className="shell">
+        <p className="mode-badge">publishableKey · public room {pkRoomId}</p>
+        <p className="hint">
+          Timeline polls use createPoll. Anonymous ballots (no voter ids in results) are POST /polls with isAnonymous: true. See README.
+        </p>
+        <FluxyRealtimeProvider workerUrl={workerUrl} publishableKey={publishableKey}>
+          <PollRoom roomId={pkRoomId} />
+        </FluxyRealtimeProvider>
+      </div>
+    );
+  }
+
+  return <MemberOrGuestApp />;
+}
+
+function MemberOrGuestApp() {
+  const { session, loading, error } = useFluxySession();
+  if (loading) return <div className="shell">Starting…</div>;
+  if (error) return <div className="shell error">{error}</div>;
+  if (!session) {
+    return (
+      <div className="shell">
+        Set <code>VITE_FLUXYCHAT_PUBLISHABLE_KEY</code>, a member JWT, or a public room id.
+      </div>
+    );
+  }
+
+  return (
+    <div className="shell">
+      <p className="mode-badge">{session.mode} · {session.roomId}</p>
+      <p className="hint">
+        Timeline polls use createPoll. Anonymous ballots: POST /polls with isAnonymous: true. See README.
+      </p>
+      <FluxyRealtimeProvider
+        workerUrl={session.workerUrl}
+        authTokenProvider={session.token}
+        userId={session.userId}
+      >
+        <PollRoom roomId={session.roomId} />
+      </FluxyRealtimeProvider>
+    </div>
+  );
+}

package/templates/polls/src/index.css

@@ -0,0 +1,85 @@
+: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;
+}
+.poll-card { margin: 0 0 1rem; padding-bottom: 0.75rem; border-bottom: 1px solid #e2e8f0; }
+.poll-options { display: flex; flex-wrap: wrap; gap: 0.5rem; }
+.poll-options button {
+  padding: 0.4rem 0.7rem;
+  border: 1px solid #cbd5e1;
+  border-radius: 8px;
+  background: #f8fafc;
+  cursor: pointer;
+}
+.poll-options button:disabled { opacity: 0.6; cursor: default; }

package/templates/polls/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/polls/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/polls/src/vite-env.d.ts

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

package/templates/polls/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/polls/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/react/.env.example

@@ -1,9 +1,13 @@
 # FluxyChat worker URL (hosted or self-hosted)
-VITE_FLUXYCHAT_WORKER_URL=https://your-worker.example.workers.dev
+VITE_FLUXYCHAT_WORKER_URL=https://api.fluxychat.com
 
-# Option A — member JWT (~2 min via onboarding)
-VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
-VITE_FLUXYCHAT_ROOM_ID=demo
+# Option A — public room, no JWT (pin @fluxy-chat/sdk@0.6.7+)
+VITE_FLUXYCHAT_PUBLISHABLE_KEY=pk_...
+VITE_FLUXYCHAT_ROOM_ID=general
 
-# Option B — public guest room (~60s, no signup)
+# Option B — member JWT
+# VITE_FLUXYCHAT_MEMBER_JWT=eyJ...
+# VITE_FLUXYCHAT_ROOM_ID=demo
+
+# Option C — guest session without pk_
 # VITE_FLUXYCHAT_PUBLIC_ROOM_ID=your-public-room-id

package/templates/react/README.md

@@ -1,43 +1,18 @@
 # FluxyChat React starter
 
-Minimal Vite + React app with `useChat`. First message in about 60 seconds via the public guest room.
-
-## Quick start (guest, fastest)
-
-```bash
-cp .env.example .env
-# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_PUBLIC_ROOM_ID (public room from console)
-npm install
-npm run dev
-```
-
-Open http://localhost:5173. A guest JWT is minted automatically via `joinPublicRoomAsGuest`.
-
-## Quick start (member JWT)
+`FluxyRealtimeProvider` + `publishableKey` + `useChat`. No member JWT mint.
 
 ```bash
 cp .env.example .env
-# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_MEMBER_JWT + VITE_FLUXYCHAT_ROOM_ID
+# Set VITE_FLUXYCHAT_WORKER_URL + VITE_FLUXYCHAT_PUBLISHABLE_KEY + room id
 npm install
 npm run dev
 ```
 
-## Get credentials
-
-1. **Guest:** create a **public** room in console, copy room ID, set `VITE_FLUXYCHAT_PUBLIC_ROOM_ID`
-2. **Member:** [fluxychat.com/onboarding](https://fluxychat.com/onboarding) for Worker URL and JWT
-3. **Local monorepo:** `pnpm run first-message` from the FluxyChat repo
-
-## Scripts
-
-| Command | Description |
-|---------|-------------|
-| `npm run dev` | Vite dev server |
-| `npm run build` | Production build |
-| `npm run preview` | Preview production build |
+Pin `@fluxy-chat/sdk@0.6.7` and `@fluxy-chat/react@0.1.6` once those versions are on npm.
 
-## Next steps
+## Other paths
 
-- Add `@fluxy-chat/ui` themes (`default`, `dark`, `minimal`, `brand`)
-- Use `useInbox` for unified feed
-- See [chat-only quickstart](https://docs.fluxychat.com/docs/getting-started/chat-only-quickstart)
+- Member JWT: `VITE_FLUXYCHAT_MEMBER_JWT`
+- Guest session: `VITE_FLUXYCHAT_PUBLIC_ROOM_ID` (`joinPublicRoomAsGuest`)
+- Credentials: [fluxychat.com/onboarding](https://fluxychat.com/onboarding) or `GET /public/demo-credentials` on a Worker that sets `PUBLIC_DEMO_PUBLISHABLE_KEY`

package/templates/react/package.json

@@ -9,8 +9,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@fluxy-chat/react": "^0.1.4",
-    "@fluxy-chat/sdk": "^0.6.5",
+    "@fluxy-chat/react": "^0.1.6",
+    "@fluxy-chat/sdk": "^0.6.7",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zustand": "^5.0.0"

package/templates/react/src/App.tsx

@@ -3,6 +3,7 @@ import { FluxyChatClient } from "@fluxy-chat/sdk";
 import { FluxyRealtimeProvider, useChat } from "@fluxy-chat/react";
 
 const workerUrl = import.meta.env.VITE_FLUXYCHAT_WORKER_URL?.trim();
+const publishableKey = import.meta.env.VITE_FLUXYCHAT_PUBLISHABLE_KEY?.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";
@@ -21,11 +22,11 @@ function useFluxySession(): {
   error: string | null;
 } {
   const [session, setSession] = useState<FluxySession | null>(null);
-  const [loading, setLoading] = useState(Boolean(workerUrl));
+  const [loading, setLoading] = useState(Boolean(workerUrl) && !publishableKey);
   const [error, setError] = useState<string | null>(null);
 
   useEffect(() => {
-    if (!workerUrl) {
+    if (!workerUrl || publishableKey) {
       setLoading(false);
       return;
     }
@@ -126,30 +127,44 @@ function ChatPanel({ roomId }: { roomId: string }) {
 }
 
 export function App() {
-  const { session, loading, error } = useFluxySession();
-  const [roomId, setRoomId] = useState(configuredRoomId);
-
-  const activeRoomId = useMemo(() => {
-    if (session?.mode === "guest") return session.roomId;
-    return roomId.trim() || configuredRoomId;
-  }, [session, roomId]);
+  const pkRoomId = publicRoomId || configuredRoomId;
 
   if (!workerUrl) {
     return (
       <main className="shell">
-        <h1>FluxyChat — chat-only starter</h1>
+        <h1>FluxyChat</h1>
         <p>
           Copy <code>.env.example</code> to <code>.env</code> and set{" "}
-          <code>VITE_FLUXYCHAT_WORKER_URL</code>.
-        </p>
-        <p>
-          Then either <code>VITE_FLUXYCHAT_MEMBER_JWT</code> (member) or{" "}
-          <code>VITE_FLUXYCHAT_PUBLIC_ROOM_ID</code> (guest, ~60s to first message).
+          <code>VITE_FLUXYCHAT_WORKER_URL</code> plus <code>VITE_FLUXYCHAT_PUBLISHABLE_KEY</code>.
         </p>
       </main>
     );
   }
 
+  if (publishableKey) {
+    return (
+      <main className="shell">
+        <h1>FluxyChat</h1>
+        <p className="mode-badge">publishableKey · public room {pkRoomId}</p>
+        <FluxyRealtimeProvider workerUrl={workerUrl} publishableKey={publishableKey}>
+          <ChatPanel roomId={pkRoomId} />
+        </FluxyRealtimeProvider>
+      </main>
+    );
+  }
+
+  return <MemberOrGuestApp />;
+}
+
+function MemberOrGuestApp() {
+  const { session, loading, error } = useFluxySession();
+  const [roomId, setRoomId] = useState(configuredRoomId);
+
+  const activeRoomId = useMemo(() => {
+    if (session?.mode === "guest") return session.roomId;
+    return roomId.trim() || configuredRoomId;
+  }, [session, roomId]);
+
   if (loading) {
     return (
       <main className="shell">
@@ -162,14 +177,7 @@ export function App() {
     return (
       <main className="shell">
         <h1>FluxyChat</h1>
-        <p className="error">{error ?? "Set JWT or public room ID in .env"}</p>
-        <p>
-          Get credentials from{" "}
-          <a href="https://fluxychat.com/onboarding" target="_blank" rel="noreferrer">
-            onboarding
-          </a>{" "}
-          or use a public room ID for guest mode.
-        </p>
+        <p className="error">{error ?? "Set pk_, JWT, or public room ID in .env"}</p>
       </main>
     );
   }

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

@@ -2,6 +2,7 @@
 
 interface ImportMetaEnv {
   readonly VITE_FLUXYCHAT_WORKER_URL: string;
+  readonly VITE_FLUXYCHAT_PUBLISHABLE_KEY?: string;
   readonly VITE_FLUXYCHAT_MEMBER_JWT?: string;
   readonly VITE_FLUXYCHAT_ROOM_ID?: string;
   readonly VITE_FLUXYCHAT_PUBLIC_ROOM_ID?: string;