1# C3 CLI Reference
2 
3## Invocation
4 
5```bash
6npm create cloudflare@latest [name] [-- flags]  # NPM requires --
7yarn create cloudflare [name] [flags]
8pnpm create cloudflare@latest [name] [-- flags]
9```
10 
11## Core Flags
12 
13| Flag | Values | Description |
14|------|--------|-------------|
15| `--type` | `hello-world`, `web-app`, `demo`, `pre-existing`, `remote-template` | Application type |
16| `--platform` | `workers` (default), `pages` | Target platform |
17| `--framework` | `next`, `remix`, `astro`, `react-router`, `solid`, `svelte`, `qwik`, `vue`, `angular`, `hono` | Web framework (requires `--type=web-app`) |
18| `--lang` | `ts`, `js`, `python` | Language (for `--type=hello-world`) |
19| `--ts` / `--no-ts` | - | TypeScript for web apps |
20 
21## Deployment Flags
22 
23| Flag | Description |
24|------|-------------|
25| `--deploy` / `--no-deploy` | Deploy immediately (prompts interactive, skips in CI) |
26| `--git` / `--no-git` | Initialize git (default: yes) |
27| `--open` | Open browser after deploy |
28 
29## Advanced Flags
30 
31| Flag | Description |
32|------|-------------|
33| `--template=user/repo` | GitHub template or local path |
34| `--existing-script=./src/worker.ts` | Existing script (requires `--type=pre-existing`) |
35| `--category=ai\|database\|realtime` | Demo filter (requires `--type=demo`) |
36| `--experimental` | Enable experimental features |
37| `--wrangler-defaults` | Skip wrangler prompts |
38 
39## Environment Variables
40 
41```bash
42CLOUDFLARE_API_TOKEN=xxx    # For deployment
43CLOUDFLARE_ACCOUNT_ID=xxx   # Account ID
44CF_TELEMETRY_DISABLED=1     # Disable telemetry
45```
46 
47## Exit Codes
48 
49`0` success, `1` user abort, `2` error
50 
51## Examples
52 
53```bash
54# TypeScript Worker
55npm create cloudflare@latest my-api -- --type=hello-world --lang=ts --no-deploy
56 
57# Next.js on Pages
58npm create cloudflare@latest my-app -- --type=web-app --framework=next --platform=pages --ts
59 
60# Astro blog
61npm create cloudflare@latest my-blog -- --type=web-app --framework=astro --ts --deploy
62 
63# CI: non-interactive
64npm create cloudflare@latest my-app -- --type=web-app --framework=next --ts --no-git --no-deploy
65 
66# GitHub template
67npm create cloudflare@latest -- --template=cloudflare/templates/worker-openapi
68 
69# Convert existing project
70npm create cloudflare@latest . -- --type=pre-existing --existing-script=./build/worker.js
71```
72