create-claudius

Scaffold a Claudius AI chat widget project in one command.

npm create claudius@latest
# or
pnpm create claudius
# or
yarn create claudius

You'll be prompted for:

• Project name — the new directory / package name
• Framework — vanilla (CDN script embed), react (Vite), or next (Next.js App Router)
• Theme — auto / light / dark, or a built-in theme (default, minimal, playful, corporate)
• Accent color — a hex color for the widget
• API URL — your deployed Claudius worker endpoint
• Optionally, a Cloudflare Worker scaffold (wrangler.toml + KV stub + deploy runbook)

The generated project runs out of the box:

cd my-app
pnpm install
pnpm dev

Non-interactive

Pass flags to skip the prompts (handy for CI):

npm create claudius@latest my-app -- \
  --template react \
  --theme auto \
  --accent "#4f46e5" \
  --api-url https://my-worker.workers.dev \
  --worker \
  --yes

| Flag | Values | Description | | --- | --- | --- | | --template | vanilla | react | next | Framework template | | --theme | auto | light | dark | default | minimal | playful | corporate | Widget theme | | --accent | #rrggbb | Accent color | | --api-url | URL | Worker chat endpoint | | --worker | — | Also scaffold a Cloudflare Worker | | --pm | npm | pnpm | yarn | bun | Package manager shown in next steps | | --yes, -y | — | Accept defaults for any unspecified prompt |

What you get

• vanilla — a static Vite site that loads the widget from the jsDelivr CDN via a single <script> tag and window.ClaudiusConfig.
• react — a Vite + React + TypeScript app using the claudius-chat-widget component and its stylesheet.
• next — a Next.js (App Router) + TypeScript app with a client-side widget wrapper.

See the documentation for worker setup and configuration.

MIT © PMDevSolutions