FluxyChat

Reference

Custom domain white-label (P12-G)

Route `https://chat.yourcompany.com` to a FluxyChat project on the Worker. Useful for embed widgets (P12-A), guest chat, and branded API endpoints without e

Route https://chat.yourcompany.com to a FluxyChat project on the Worker. Useful for embed widgets (P12-A), guest chat, and branded API endpoints without exposing the platform api.* hostname.

How it works

sequenceDiagram
  participant Browser
  participant CF as Cloudflare custom hostname
  participant Worker
  participant D1

  Browser->>CF: HTTPS chat.acme.com
  CF->>Worker: same Worker script
  Worker->>D1: project_custom_domains hostname=chat.acme.com status=active
  Worker-->>Browser: project-scoped API + CORS for chat.acme.com
  1. Register hostname in dashboard /custom-domains (status pending).
  2. Attach custom hostname in Cloudflare (for SaaS or Workers custom domain) with TLS.
  3. Activate domain in dashboard (status: active) once DNS + certificate are ready.
  4. Requests to that host resolve projectId from the hostname (no API key required).
  5. JWTs must match the host project (tid claim enforced).

Operator checklist

StepAction
DNS / TLSCloudflare Custom Hostnames or Worker custom domain → same Worker
Worker envWORKER_PLATFORM_HOSTS=api.fluxychat.com,fluxychat-worker.workers.dev (comma-separated platform hosts that skip white-label lookup)
CORSPer-domain allowedOrigins on the domain row + auto https://\{hostname\}
Default roomOptional defaultRoomId for embed / guest landing
Guest chatGET /public/host-config returns \{ projectId, defaultRoomId, brand \}

API

MethodPathAuthPurpose
GET/public/host-confignoneDiscover project from request hostname
GET/admin/custom-domainsadmin JWTList domains for project
POST/admin/custom-domainsadmin JWTRegister hostname
PATCH/admin/custom-domains/:idadmin JWTActivate / disable / branding
DELETE/admin/custom-domains/:idadmin JWTRemove mapping

SDK

const config = await client.getPublicHostConfig();
const { domains } = await client.listCustomDomains();
await client.createCustomDomain({ hostname: "chat.acme.com", defaultRoomId: "support" });
await client.updateCustomDomain(id, { status: "active" });

Security

  • Hostname must be a valid DNS name (no www. prefix — use chat. subdomains).
  • Guest sessions on a custom host only work for rooms in that project.
  • Cross-tenant JWTs are rejected on white-label hosts.

Theming and data-theme (P14-I)

White-label the chat shell on your marketing site and embed iframe:

  1. Set data-theme on the host page (or <html>) so your CSS can scope brand tokens:
<html lang="en" data-theme="acme">
  <head>
    <style>
      [data-theme="acme"] {
        --fluxy-primary: #0d9488;
        --fluxy-surface: #f0fdfa;
        --fluxy-text: #134e4a;
      }
    </style>
  </head>

  1. Configure embed theme in dashboard Embed widget — saves primaryColor and launcher position; the generated snippet includes data-primary-color and data-position.

  2. On custom domains, GET /public/host-config returns optional brand JSON — use it to set data-theme dynamically:

const host = await client.getPublicHostConfig();
document.documentElement.setAttribute("data-theme", host.brand?.themeId ?? "default");
  1. For full SDK embeds (not the bubble), pass the same CSS variables into your React app wrapping @fluxy-chat/ui components.

Browser Run (P12-K)

When `env.BROWSER` is bound, FluxyChat uses [Browser Run Quick Actions](https://developers.cloudflare.com/browser-run/quick-actions/) for richer link previews o

Daily AI digest (P12-F)

Cron-driven recap of yesterday’s chat activity: three AI-generated highlights per opted-in user, delivered via in-app notification, web push, and optional email

On this page

How it worksOperator checklistAPISDKSecurityTheming and data-theme (P14-I)Related