/cloudflare-deploy

Cloudflare Pages

JAMstack platform for full-stack apps on Cloudflare's global network.

Key Features

• Git-based deploys: Auto-deploy from GitHub/GitLab
• Preview deployments: Unique URL per branch/PR
• Pages Functions: File-based serverless routing (Workers runtime)
• Static + dynamic: Smart asset caching + edge compute
• Smart Placement: Automatic function optimization based on traffic patterns
• Framework optimized: SvelteKit, Astro, Nuxt, Qwik, Solid Start

Deployment Methods

1. Git Integration (Production)

Dashboard → Workers & Pages → Create → Connect to Git → Configure build

2. Direct Upload

npx wrangler pages deploy ./dist --project-name=my-project
npx wrangler pages deploy ./dist --project-name=my-project --branch=staging

3. C3 CLI

npm create cloudflare@latest my-app
# Select framework → auto-setup + deploy

vs Workers

• Pages: Static sites, JAMstack, frameworks, git workflow, file-based routing
• Workers: Pure APIs, complex routing, WebSockets, scheduled tasks, email handlers
• Combine: Pages Functions use Workers runtime, can bind to Workers

Quick Start

# Create
npm create cloudflare@latest

# Local dev
npx wrangler pages dev ./dist

# Deploy
npx wrangler pages deploy ./dist --project-name=my-project

# Types
npx wrangler types --path='./functions/types.d.ts'

# Secrets
echo "value" | npx wrangler pages secret put KEY --project-name=my-project

# Logs
npx wrangler pages deployment tail --project-name=my-project

Resources

• Pages Docs
• Functions API
• Framework Guides
• Discord #functions

Reading Order

New to Pages? Start here:

1. README.md (you are here) - Overview & quick start
2. configuration.md - Project setup, wrangler.jsonc, bindings
3. api.md - Functions API, routing, context
4. patterns.md - Common implementations
5. gotchas.md - Troubleshooting & pitfalls

Quick reference? Jump to relevant file above.

In This Reference

• configuration.md - wrangler.jsonc, build, env vars, Smart Placement
• api.md - Functions API, bindings, context, advanced mode
• patterns.md - Full-stack patterns, framework integration
• gotchas.md - Build issues, limits, debugging, framework warnings

See Also

• pages-functions - File-based routing, middleware
• d1 - SQL database for Pages Functions
• kv - Key-value storage for caching/state