create-claudius 1.8.0 → 1.9.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 PMDevSolutions
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 PMDevSolutions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,68 +1,68 @@
-# create-claudius
-
-[![npm](https://img.shields.io/npm/v/create-claudius.svg)](https://www.npmjs.com/package/create-claudius)
-
-Scaffold a [Claudius](https://claudius-docs.pages.dev) AI chat widget project in
-one command.
-
-```bash
-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:
-
-```bash
-cd my-app
-pnpm install
-pnpm dev
-```
-
-## Non-interactive
-
-Pass flags to skip the prompts (handy for CI):
-
-```bash
-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](https://claudius-docs.pages.dev) for worker setup and
-configuration.
-
-MIT © PMDevSolutions
+# create-claudius
+
+[![npm](https://img.shields.io/npm/v/create-claudius.svg)](https://www.npmjs.com/package/create-claudius)
+
+Scaffold a [Claudius](https://claudius-docs.pages.dev) AI chat widget project in
+one command.
+
+```bash
+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:
+
+```bash
+cd my-app
+pnpm install
+pnpm dev
+```
+
+## Non-interactive
+
+Pass flags to skip the prompts (handy for CI):
+
+```bash
+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](https://claudius-docs.pages.dev) for worker setup and
+configuration.
+
+MIT © PMDevSolutions

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "create-claudius",
-  "version": "1.8.0",
-  "description": "Scaffold a Claudius AI chat widget project in one command.",
-  "keywords": [
-    "claudius",
-    "create",
-    "create-claudius",
-    "scaffold",
-    "cli",
-    "chat-widget",
-    "claude",
-    "ai-chat"
-  ],
-  "author": "PAMulligan",
-  "license": "MIT",
-  "homepage": "https://claudius-docs.pages.dev",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/PMDevSolutions/Claudius.git",
-    "directory": "create-claudius"
-  },
-  "bugs": {
-    "url": "https://github.com/PMDevSolutions/Claudius/issues"
-  },
-  "type": "module",
-  "bin": {
-    "create-claudius": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "templates"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.7.0",
-    "picocolors": "^1.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsup": "^8.3.0",
-    "typescript": "^5.8.0",
-    "vitest": "^4.1.0"
-  }
-}
+{
+  "name": "create-claudius",
+  "version": "1.9.0",
+  "description": "Scaffold a Claudius AI chat widget project in one command.",
+  "keywords": [
+    "claudius",
+    "create",
+    "create-claudius",
+    "scaffold",
+    "cli",
+    "chat-widget",
+    "claude",
+    "ai-chat"
+  ],
+  "author": "PAMulligan",
+  "license": "MIT",
+  "homepage": "https://claudius-docs.pages.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PMDevSolutions/Claudius.git",
+    "directory": "create-claudius"
+  },
+  "bugs": {
+    "url": "https://github.com/PMDevSolutions/Claudius/issues"
+  },
+  "type": "module",
+  "bin": {
+    "create-claudius": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.0"
+  }
+}

package/templates/next/README.md

@@ -1,23 +1,23 @@
-# {{PROJECT_NAME}}
-
-A [Next.js](https://nextjs.org) (App Router) + TypeScript app using the
-[`claudius-chat-widget`](https://www.npmjs.com/package/claudius-chat-widget)
-component.
-
-```bash
-pnpm install
-pnpm dev
-```
-
-The widget is rendered by a client component (`app/ClaudiusWidget.tsx`) because it
-relies on browser APIs:
-
-```tsx
-"use client";
-import { ChatWidget } from "claudius-chat-widget";
-import "claudius-chat-widget/style.css";
-```
-
-You need a running Claudius worker for the chat to respond. See the
-[worker setup guide](https://claudius-docs.pages.dev/deployment/worker/), or
-re-run the scaffolder with `--worker` to generate one.
+# {{PROJECT_NAME}}
+
+A [Next.js](https://nextjs.org) (App Router) + TypeScript app using the
+[`claudius-chat-widget`](https://www.npmjs.com/package/claudius-chat-widget)
+component.
+
+```bash
+pnpm install
+pnpm dev
+```
+
+The widget is rendered by a client component (`app/ClaudiusWidget.tsx`) because it
+relies on browser APIs:
+
+```tsx
+"use client";
+import { ChatWidget } from "claudius-chat-widget";
+import "claudius-chat-widget/style.css";
+```
+
+You need a running Claudius worker for the chat to respond. See the
+[worker setup guide](https://claudius-docs.pages.dev/deployment/worker/), or
+re-run the scaffolder with `--worker` to generate one.

package/templates/next/_gitignore

@@ -1,7 +1,7 @@
-node_modules
-.next
-out
-dist
-*.local
-.DS_Store
-next-env.d.ts
+node_modules
+.next
+out
+dist
+*.local
+.DS_Store
+next-env.d.ts

package/templates/next/app/ClaudiusWidget.tsx

@@ -1,16 +1,16 @@
-"use client";
-
-import { ChatWidget } from "claudius-chat-widget";
-import "claudius-chat-widget/style.css";
-
-// ChatWidget uses browser APIs and React state, so it must run on the client.
-export function ClaudiusWidget() {
-  return (
-    <ChatWidget
-      apiUrl="{{API_URL}}"
-      title="{{PROJECT_NAME}}"
-      theme="{{THEME}}"
-      accentColor="{{ACCENT_COLOR}}"
-    />
-  );
-}
+"use client";
+
+import { ChatWidget } from "claudius-chat-widget";
+import "claudius-chat-widget/style.css";
+
+// ChatWidget uses browser APIs and React state, so it must run on the client.
+export function ClaudiusWidget() {
+  return (
+    <ChatWidget
+      apiUrl="{{API_URL}}"
+      title="{{PROJECT_NAME}}"
+      theme="{{THEME}}"
+      accentColor="{{ACCENT_COLOR}}"
+    />
+  );
+}

package/templates/next/app/layout.tsx

@@ -1,15 +1,15 @@
-import type { Metadata } from "next";
-import type { ReactNode } from "react";
-
-export const metadata: Metadata = {
-  title: "{{PROJECT_NAME}}",
-  description: "A Claudius-powered app",
-};
-
-export default function RootLayout({ children }: { children: ReactNode }) {
-  return (
-    <html lang="en">
-      <body style={{ margin: 0 }}>{children}</body>
-    </html>
-  );
-}
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+
+export const metadata: Metadata = {
+  title: "{{PROJECT_NAME}}",
+  description: "A Claudius-powered app",
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body style={{ margin: 0 }}>{children}</body>
+    </html>
+  );
+}

package/templates/next/app/page.tsx

@@ -1,24 +1,24 @@
-import { ClaudiusWidget } from "./ClaudiusWidget";
-
-export default function Home() {
-  return (
-    <main
-      style={{
-        fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, sans-serif",
-        display: "grid",
-        placeItems: "center",
-        minHeight: "100vh",
-      }}
-    >
-      <div style={{ maxWidth: "32rem", padding: "2rem", textAlign: "center" }}>
-        <h1>{{PROJECT_NAME}}</h1>
-        <p>
-          Edit <code>app/ClaudiusWidget.tsx</code> to configure the widget. The launcher
-          is in the corner.
-        </p>
-      </div>
-
-      <ClaudiusWidget />
-    </main>
-  );
-}
+import { ClaudiusWidget } from "./ClaudiusWidget";
+
+export default function Home() {
+  return (
+    <main
+      style={{
+        fontFamily: "system-ui, -apple-system, Segoe UI, Roboto, sans-serif",
+        display: "grid",
+        placeItems: "center",
+        minHeight: "100vh",
+      }}
+    >
+      <div style={{ maxWidth: "32rem", padding: "2rem", textAlign: "center" }}>
+        <h1>{{PROJECT_NAME}}</h1>
+        <p>
+          Edit <code>app/ClaudiusWidget.tsx</code> to configure the widget. The launcher
+          is in the corner.
+        </p>
+      </div>
+
+      <ClaudiusWidget />
+    </main>
+  );
+}

package/templates/next/next.config.mjs

@@ -1,4 +1,4 @@
-/** @type {import('next').NextConfig} */
-const nextConfig = {};
-
-export default nextConfig;
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+export default nextConfig;

package/templates/next/package.json

@@ -1,22 +1,22 @@
-{
-  "name": "{{PROJECT_NAME}}",
-  "private": true,
-  "version": "0.0.0",
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start"
-  },
-  "dependencies": {
-    "claudius-chat-widget": "{{WIDGET_VERSION}}",
-    "next": "^14.2.0",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "@types/react": "^18.3.0",
-    "@types/react-dom": "^18.3.0",
-    "typescript": "^5.6.0"
-  }
-}
+{
+  "name": "{{PROJECT_NAME}}",
+  "private": true,
+  "version": "0.0.0",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "claudius-chat-widget": "{{WIDGET_VERSION}}",
+    "next": "^14.2.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.6.0"
+  }
+}

package/templates/next/tsconfig.json

@@ -1,21 +1,21 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["dom", "dom.iterable", "esnext"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "preserve",
-    "incremental": true,
-    "plugins": [{ "name": "next" }],
-    "paths": { "@/*": ["./*"] }
-  },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/react/README.md

@@ -1,23 +1,23 @@
-# {{PROJECT_NAME}}
-
-A [Vite](https://vite.dev) + React + TypeScript app using the
-[`claudius-chat-widget`](https://www.npmjs.com/package/claudius-chat-widget)
-component.
-
-```bash
-pnpm install
-pnpm dev
-```
-
-The widget lives in `src/App.tsx`:
-
-```tsx
-import { ChatWidget } from "claudius-chat-widget";
-import "claudius-chat-widget/style.css";
-
-<ChatWidget apiUrl="{{API_URL}}" theme="{{THEME}}" accentColor="{{ACCENT_COLOR}}" />;
-```
-
-You need a running Claudius worker for the chat to respond. See the
-[worker setup guide](https://claudius-docs.pages.dev/deployment/worker/), or
-re-run the scaffolder with `--worker` to generate one.
+# {{PROJECT_NAME}}
+
+A [Vite](https://vite.dev) + React + TypeScript app using the
+[`claudius-chat-widget`](https://www.npmjs.com/package/claudius-chat-widget)
+component.
+
+```bash
+pnpm install
+pnpm dev
+```
+
+The widget lives in `src/App.tsx`:
+
+```tsx
+import { ChatWidget } from "claudius-chat-widget";
+import "claudius-chat-widget/style.css";
+
+<ChatWidget apiUrl="{{API_URL}}" theme="{{THEME}}" accentColor="{{ACCENT_COLOR}}" />;
+```
+
+You need a running Claudius worker for the chat to respond. See the
+[worker setup guide](https://claudius-docs.pages.dev/deployment/worker/), or
+re-run the scaffolder with `--worker` to generate one.

package/templates/react/_gitignore

@@ -1,4 +1,4 @@
-node_modules
-dist
-*.local
-.DS_Store
+node_modules
+dist
+*.local
+.DS_Store

package/templates/react/index.html

@@ -1,12 +1,12 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>{{PROJECT_NAME}}</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{PROJECT_NAME}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>