FluxyChatHow-to Guides
create-fluxy-chat CLI
Scaffold a chat app or a bot worker. Use the scoped npm package.
Always:
npx @fluxy-chat/create-fluxy-chat@latestUnscoped npx create-fluxy-chat is not our package.
Chat app (what most people want)
# Hosted — Clerk, no wrangler
npx @fluxy-chat/create-fluxy-chat@latest my-app --mode hosted -y
# Your Worker
npx @fluxy-chat/create-fluxy-chat@latest my-app --full --mode self-hostThen cd my-app && pnpm install.
- Hosted:
pnpm setup:hosted && pnpm dev - Self-host: start the Worker, then
pnpm setup:local && pnpm dev
The interactive CLI asks for Worker URL and optional Groq key when you pick self-host. It writes .fluxy/worker.dev.vars so you can paste secrets into apps/worker/.dev.vars after you clone the FluxyChat repo.
Details: Choose your path.
Smaller templates
npx @fluxy-chat/create-fluxy-chat@latest my-chat --template react
npx @fluxy-chat/create-fluxy-chat@latest my-chat --minimal
npx @fluxy-chat/create-fluxy-chat@latest my-hr --template hr-feedbackReact/minimal: copy .env.example and set Worker URL + JWT. Auth JWT.
Bot workers (Slack / Telegram / Discord)
npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter slack --pm pnpm
npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter telegram --skip-install
npx @fluxy-chat/create-fluxy-chat@latest my-bot -y --adapter discord
npx @fluxy-chat/create-fluxy-chat@latest my-bot --adapter basicThese generate a small Cloudflare Worker (src/index.ts, src/bot.ts, wrangler.toml, .dev.vars). Fill FLUXY_BASE_URL and FLUXY_API_KEY, then pnpm dev / pnpm deploy.
| Flag | Meaning |
|---|---|
--mode hosted | local | self-host | self-host is the same as local (your Worker) |
--full | Vite app + setup scripts |
--adapter / --template | full, react, minimal, hr-feedback, basic, slack, telegram, discord, web |
-y | Skip prompts |
See also: Unified chat API, SDK.