create-fluxy-chat

Scaffold a new FluxyChat bot project with a single command.

Quick Start

npx create-fluxy-chat my-bot

This launches an interactive prompt to configure your bot project.

Non-Interactive Usage

# Create a Slack bot with pnpm
npx create-fluxy-chat my-bot --adapter slack --pm pnpm

# Create a Telegram bot, skip install
npx create-fluxy-chat my-bot --adapter telegram --skip-install

# Create a Discord bot with defaults
npx create-fluxy-chat my-bot -y --adapter discord

# Create a basic webhook bot
npx create-fluxy-chat my-bot --adapter basic

Options

| Flag | Short | Description | | --- | --- | --- | | --adapter <type> | -a | Adapter: basic, slack, telegram, discord, web | | --pm <manager> | | Package manager: npm, pnpm, yarn | | --language <lang> | -l | Language: typescript (default) or javascript | | --yes | -y | Skip prompts and accept defaults | | --skip-install | | Skip dependency installation | | --no-git | | Skip git repository initialization | | --help | -h | Show help |

Adapters

| Adapter | Description | Platform | | --- | --- | --- | | basic | Generic webhook bot | Cloudflare Workers | | slack | Slack Events API bot | Slack | | telegram | Telegram webhook bot | Telegram | | discord | Discord interactions bot | Discord | | web | Web chat HTTP API bot | Any HTTP client |

What You Get

Each generated project includes:

• src/index.ts — Cloudflare Workers entry point with route handling
• src/bot.ts — Bot handler using @fluxy-chat/sdk
• wrangler.toml — Cloudflare Workers deployment config
• .dev.vars — Local development environment variables
• .env.example — Example environment variables for your adapter
• tsconfig.json — TypeScript configuration (for TS projects)
• README.md — Project-specific setup instructions
• .gitignore — Standard ignore patterns

Package Manager Detection

The CLI auto-detects your package manager from lockfiles:

• pnpm-lock.yaml → pnpm
• yarn.lock → yarn
• package-lock.json or none → npm

You can override with --pm.

Development

# Install dependencies
pnpm install

# Build the CLI
pnpm build

# Run locally
node dist/index.js my-test-bot -y --adapter basic

License

MIT