Loading…
Search, Ask AI, and the full SDK reference live on the docs site. This page is the short path for the things people ask for first: auth, SDK setup, and the playground.
Search, Ask AI, SDK reference, platform modules, cookbooks, and 160+ pages on docs.fluxychat.com.
Open docs siteAccount, SDK install, and first room message on FluxyChat Cloud.
QuickstartKeep API keys on the server. Mint member JWTs with POST /auth/token. Never expose admin tokens in the browser.
Auth guideFluxyChatClient, useChat, rooms, and WebSocket delivery against hosted or self-hosted Workers.
SDK referenceDeploy apps/worker and D1 when you need an isolated tenant or your own compliance boundary.
Self-host guideRoom events, AI invokes, and Stripe billing hooks on the Worker.
Agents docsFluxyStream, FluxyCollab, FluxyGame, and FluxyIoT on the same room and worker as chat.
Platform overviewProjects, rooms, analytics, and billing after you connect an account.
Open wizardAPI key (fc_...): server-to-server, identifies your project. Store in env on your backend only.
JWT: for browsers and the SDK. Mint with POST /auth/token and header X-Fluxy-Api-Key. Claims include sub (user id), tid (project id), and roles.
With Clerk enabled, the dashboard provisions your tenant and mints operator JWTs server-side. You do not paste bootstrap keys in the browser.
pnpm add @fluxy-chat/react
import { FluxyRealtimeProvider, useChat } from "@fluxy-chat/react";
<FluxyRealtimeProvider workerUrl={process.env.NEXT_PUBLIC_FLUXYCHAT_CLOUD_URL} publishableKey="pk_...">
<Chat />
</FluxyRealtimeProvider>
function Chat() {
const { messages, sendMessage } = useChat({ roomId: "general" });
}Native Dart SDK is in this repo (`packages/flutter-sdk`). Not on pub.dev yet. Path dependency from GitHub until we publish.
flutter pub add fluxychat_sdk
import 'package:fluxychat_sdk/fluxychat_sdk.dart';
final client = FluxyChatClient(
config: FluxyChatConfig(
apiUrl: 'https://your-worker.workers.dev',
wsUrl: 'wss://your-worker.workers.dev',
projectId: 'proj_123',
token: 'your-jwt-token',
),
);Run live FluxyChat SDK examples in your browser via StackBlitz. No setup required. Each project is fully configured with the SDK and a public demo endpoint.
Connect to FluxyChat, join a room, and send/receive messages
Full React app with useChat hook, room list, and message history
Chat with an AI agent using streaming markdown and tool calls
Vite-style React chat with @assistant invoke against the public demo session
Configure outbound webhooks per project in the console. Stripe checkout and usage quotas are enforced on the Worker upgrade plans from Billing after you connect an account.
VAPID + RFC 8188 encrypted browser push, self-hosted and wire-compatible with Pusher Beams. Fetch the project public key from GET /push/web/vapid-public-key and register the browser's PushSubscription via POST /push/web/subscribe. No third-party push service required. Full protocol notes, SDK usage, and service worker snippet in docs/web-push-vapid.md.