# Interactive (recommended for first-time)
npm create cloudflare@latest my-app

# Worker (API/WebSocket/Cron)
npm create cloudflare@latest my-api -- --type=hello-world --ts

# Pages (static/SSG)
npm create cloudflare@latest my-site -- --type=web-app --framework=astro --platform=pages

Platform Decision Tree

What are you building?

├─ API / WebSocket / Cron / Email handler
│   └─ Workers (default) - no --platform flag needed
│       npm create cloudflare@latest my-api -- --type=hello-world

├─ Static site / SSG / Documentation
│   └─ Pages - requires --platform=pages
│       npm create cloudflare@latest my-site -- --type=web-app --framework=astro --platform=pages

├─ Full-stack app (Next.js/Remix/SvelteKit)
│   └─ Follow the current framework guide below

└─ Convert existing project
    └─ npm create cloudflare@latest . -- --type=pre-existing --existing-script=./src/worker.ts

Critical: Pages projects require --platform=pages flag. Without it, C3 defaults to Workers.

Framework Setup

Fetch the Workers framework guide for the chosen framework before scaffolding or adapting an existing app. For Next.js, follow Next.js on Workers; use the Pages static export guide only when targeting a Next.js static export on Pages.

Interactive Flow

When run without flags, C3 prompts in this order:

Project name - Directory to create (defaults to current dir with .)
Application type - hello-world, web-app, demo, pre-existing, remote-template
Platform - workers (default) or pages (for web apps only)
Framework - If web-app: next, remix, astro, react-router, solid, svelte, etc.
TypeScript - yes (recommended) or no
Git - Initialize repository? yes or no
Deploy - Deploy now? yes or no (requires wrangler login)

Installation Methods

# NPM
npm create cloudflare@latest

# Yarn
yarn create cloudflare

# PNPM
pnpm create cloudflare@latest

In This Reference

File	Purpose	Use When
api.md	Complete CLI flag reference	Scripting, CI/CD, advanced usage
configuration.md	Generated files, bindings, types	Understanding output, customization
patterns.md	Workflows, CI/CD, monorepos	Real-world integration
gotchas.md	Troubleshooting failures	Deployment blocked, errors

Reading Order

Task	Read
Create first project	README only
Set up CI/CD	README → api → patterns
Debug failed deploy	gotchas
Understand generated files	configuration
Full CLI reference	api
Create custom template	patterns → configuration
Convert existing project	README → patterns

Post-Creation

cd my-app

# Local dev with hot reload
npm run dev

# Generate TypeScript types for bindings
npm run cf-typegen

# Deploy to Cloudflare
npm run deploy

README.md

C3 (create-cloudflare)

Quick Start