1# C3 Usage Patterns
2 
3## Quick Workflows
4 
5```bash
6# TypeScript API Worker
7npm create cloudflare@latest my-api -- --type=hello-world --lang=ts --deploy
8 
9# Next.js on Pages
10npm create cloudflare@latest my-app -- --type=web-app --framework=next --platform=pages --ts --deploy
11 
12# Astro static site  
13npm create cloudflare@latest my-blog -- --type=web-app --framework=astro --platform=pages --ts
14```
15 
16## CI/CD (GitHub Actions)
17 
18```yaml
19- name: Deploy
20  run: npm run deploy
21  env:
22    CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
23    CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
24```
25 
26**Non-interactive requires:**
27```bash
28--type=<value>       # Required
29--no-git             # Recommended (CI already in git)
30--no-deploy          # Deploy separately with secrets
31--framework=<value>  # For web-app
32--ts / --no-ts       # Required
33```
34 
35## Monorepo
36 
37C3 detects workspace config (`package.json` workspaces or `pnpm-workspace.yaml`).
38 
39```bash
40cd packages/
41npm create cloudflare@latest my-worker -- --type=hello-world --lang=ts --no-deploy
42```
43 
44## Custom Templates
45 
46```bash
47# GitHub repo
48npm create cloudflare@latest -- --template=username/repo
49npm create cloudflare@latest -- --template=cloudflare/templates/worker-openapi
50 
51# Local path
52npm create cloudflare@latest my-app -- --template=../my-template
53```
54 
55**Template requires `c3.config.json`:**
56```json
57{
58  "name": "my-template",
59  "category": "hello-world",
60  "copies": [{ "path": "src/" }, { "path": "wrangler.jsonc" }],
61  "transforms": [{ "path": "package.json", "jsonc": { "name": "{{projectName}}" }}]
62}
63```
64 
65## Existing Projects
66 
67```bash
68# Add Cloudflare to existing Worker
69npm create cloudflare@latest . -- --type=pre-existing --existing-script=./dist/index.js
70 
71# Add to existing framework app
72npm create cloudflare@latest . -- --type=web-app --framework=next --platform=pages --ts
73```
74 
75## Post-Creation Checklist
76 
771. Review `wrangler.jsonc` - set `compatibility_date`, verify `name`
782. Create bindings: `wrangler kv namespace create`, `wrangler d1 create`, `wrangler r2 bucket create`
793. Generate types: `npm run cf-typegen`
804. Test: `npm run dev`
815. Deploy: `npm run deploy`
826. Set secrets: `wrangler secret put SECRET_NAME`
83