Beta build. Report issues to your operator channel.
fluxychat

Public rooms start in the browser. Console sign-in is for hosted ops.

Put a pk_ on FluxyRealtimeProvider and call useChat. Sign in only if you want hosted cloud, billing, or Bridges. Self-host with a manual admin JWT in the wizard.

Quickstart wizard

Quickstart

Get your first message live

Account, SDK, first public room. Company legal pages: /for-teams. Self-hosting is optional; see advanced. Positioning and tradeoffs: /why.

SDK quickstart

pnpm add @fluxy-chat/react
NEXT_PUBLIC_FLUXYCHAT_CLOUD_URL=https://api.fluxychat.com
import { FluxyRealtimeProvider, useChat } from "@fluxy-chat/react";

<FluxyRealtimeProvider workerUrl={workerUrl} publishableKey="pk_...">
  <Chat />
</FluxyRealtimeProvider>

function Chat() {
  const { messages, sendMessage } = useChat({ roomId: "general" });
}

Custom bots: FluxyMessageStream. See docs/cookbook/bot-streaming-fluxy-message-stream.md

Chat only

Fastest path: minimal CLI or drop-in widget

Scaffold a chat-only Vite app in one command. Public rooms: publishableKey on the provider, or guest on FluxyChatWidget. No card. Free hosted is beta. For headless control, use useChat.

npx @fluxy-chat/create-fluxy-chat@latest my-chat --minimal
pnpm add @fluxy-chat/ui-kit
Open onboarding wizardChat-only quickstartui-kit README

Step-by-step afternoon guide in the repo: docs/quickstart-afternoon.md.

  1. Step 1

    Public room with pk_

    npx @fluxy-chat/create-fluxy-chat@latest my-room --example shared-ai-room. Guest join, two tabs. Console signup is later, for ops.

  2. Step 2

    Or install the SDK in your app

    pnpm add @fluxy-chat/react. FluxyRealtimeProvider plus publishableKey (pk_). No token endpoint on public rooms.

  3. Step 3

    Self-host the Worker when you need it

    wrangler deploy on your Cloudflare account. Hosted cloud is beta if you want us to run the Worker.

  4. Step 4

    Console for agents, quotas, billing

    Sign in when you need JWT minting, agents, or invoices. Not required to try a public room.

  5. Step 5

    Member JWT for private rooms

    POST /auth/token with X-Fluxy-Api-Key (fc_ stays on the server). pk_ cannot mint member tokens.

View docsProduct overview

Self-host on Cloudflare (advanced)

Deploy the Worker and D1 from the monorepo when you need your own Cloudflare account or an isolated tenant. Most teams start on hosted cloud and move here when compliance or scale asks for it.

  • Fork or clone the repo, deploy apps/worker
  • Set NEXT_PUBLIC_FLUXYCHAT_WORKER_URL in your app
  • Mint JWTs with your project API key. See docs/cookbook/auth-jwt.md

Deploy Worker to CloudflareWorker README on GitHubManual setup wizard