Files
dotfiles/dot_agents/skills/cloudflare/references/pages
Prad Nukala 6406208b35 shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents
- 16 cross-shell utilities converted to sh/bash chezmoi executables:
  ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone
  ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj
  (ghg-clone not named ghg: unrelated cargo binary owns that name)
- cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho
  cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files
- fish keeps only shell-state functions; converted ones now hit PATH
- cp-appid ignore gating moved to .local/bin path
- dot_agents/skills: 82 skills materialized from dotstate storage so
  dot_claude skill symlinks resolve on fresh bootstrap; dotstate
  profile/symlinks.json released .agents/skills .bashrc .zshrc
2026-08-10 15:15:06 -04:00
..

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

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