1# Cloudflare Pages
2 
3JAMstack platform for full-stack apps on Cloudflare's global network.
4 
5## Key Features
6 
7- **Git-based deploys**: Auto-deploy from GitHub/GitLab
8- **Preview deployments**: Unique URL per branch/PR
9- **Pages Functions**: File-based serverless routing (Workers runtime)
10- **Static + dynamic**: Smart asset caching + edge compute
11- **Smart Placement**: Automatic function optimization based on traffic patterns
12- **Framework optimized**: SvelteKit, Astro, Nuxt, Qwik, Solid Start
13 
14## Deployment Methods
15 
16### 1. Git Integration (Production)
17Dashboard → Workers & Pages → Create → Connect to Git → Configure build
18 
19### 2. Direct Upload
20```bash
21npx wrangler pages deploy ./dist --project-name=my-project
22npx wrangler pages deploy ./dist --project-name=my-project --branch=staging
23```
24 
25### 3. C3 CLI
26```bash
27npm create cloudflare@latest my-app
28# Select framework → auto-setup + deploy
29```
30 
31## vs Workers
32 
33- **Pages**: Static sites, JAMstack, frameworks, git workflow, file-based routing
34- **Workers**: Pure APIs, complex routing, WebSockets, scheduled tasks, email handlers
35- **Combine**: Pages Functions use Workers runtime, can bind to Workers
36 
37## Quick Start
38 
39```bash
40# Create
41npm create cloudflare@latest
42 
43# Local dev
44npx wrangler pages dev ./dist
45 
46# Deploy
47npx wrangler pages deploy ./dist --project-name=my-project
48 
49# Types
50npx wrangler types --path='./functions/types.d.ts'
51 
52# Secrets
53echo "value" | npx wrangler pages secret put KEY --project-name=my-project
54 
55# Logs
56npx wrangler pages deployment tail --project-name=my-project
57```
58 
59## Resources
60 
61- [Pages Docs](https://developers.cloudflare.com/pages/)
62- [Functions API](https://developers.cloudflare.com/pages/functions/api-reference/)
63- [Framework Guides](https://developers.cloudflare.com/pages/framework-guides/)
64- [Discord #functions](https://discord.com/channels/595317990191398933/910978223968518144)
65 
66## Reading Order
67 
68**New to Pages?** Start here:
691. README.md (you are here) - Overview & quick start
702. [configuration.md](./configuration.md) - Project setup, wrangler.jsonc, bindings
713. [api.md](./api.md) - Functions API, routing, context
724. [patterns.md](./patterns.md) - Common implementations
735. [gotchas.md](./gotchas.md) - Troubleshooting & pitfalls
74 
75**Quick reference?** Jump to relevant file above.
76 
77## In This Reference
78 
79- [configuration.md](./configuration.md) - wrangler.jsonc, build, env vars, Smart Placement
80- [api.md](./api.md) - Functions API, bindings, context, advanced mode
81- [patterns.md](./patterns.md) - Full-stack patterns, framework integration
82- [gotchas.md](./gotchas.md) - Build issues, limits, debugging, framework warnings
83 
84## See Also
85 
86- [pages-functions](../pages-functions/) - File-based routing, middleware
87- [d1](../d1/) - SQL database for Pages Functions
88- [kv](../kv/) - Key-value storage for caching/state
89