# Cloudflare Pages [[Cloudflare]] Pages is a JAMstack hosting platform for static sites and full-stack applications, deployed to Cloudflare's global edge network. A repository is connected (GitHub, GitLab, or direct upload via Wrangler), a build command runs, and the output is published to a `*.pages.dev` subdomain with automatic preview deployments on every branch and pull request. Pages started as a pure static-site host competing with [[GitHub Pages]], [[Vercel]], and Netlify, but converged with [[Cloudflare Workers]] through Pages Functions — file-based serverless routes that ship alongside the static output. The two products are now being unified under Workers Static Assets, where the distinction between "static site" and "Worker with assets" essentially disappears. ## Why It Matters Free tier is generous enough to host real production sites: unlimited bandwidth, 500 builds/month, 100 custom domains per project, and unlimited static requests. No bandwidth charges at any tier — a structural difference vs Vercel and Netlify, where egress is the cost that bites at scale. Combined with [[Cloudflare]]'s anycast network, Pages serves assets from 300+ POPs without configuration. For PKM-as-publishing workflows it pairs naturally with [[Git]]-backed knowledge bases: push a markdown vault, run a static generator in CI, get a fast public site. The [[PKM AI Wiki]] and [[AI Wiki Template]] use this exact pipeline. ## Common Use Cases - **Documentation sites and wikis**: markdown → static HTML → edge - **Marketing sites**: Astro, Next.js (static export), Hugo, Eleventy - **JAMstack apps with edge functions**: forms, auth, lightweight APIs via Pages Functions - **Preview environments**: every PR gets a unique deployment URL - **Personal knowledge bases**: Obsidian + Quartz, Logseq, mdBook published to a custom domain ## Limits Worth Knowing - **File count per deployment**: 20,000 files on Free; 100,000 on paid plans since January 23, 2026 (set `PAGES_WRANGLER_MAJOR_VERSION=4` in the project settings) - **Single file size**: 25 MiB - **Builds**: 500 per month and 1 at a time on Free (5,000 and 5 concurrent on Pro); each build times out after 20 minutes - **Pages Functions**: same runtime as [[Cloudflare Workers]] (V8 isolates, no Node by default) - **Migration direction**: Cloudflare's docs now say it outright: Workers is "Cloudflare's primary platform for building applications. Start new projects with Workers." Pages still works and still gets maintenance (it skips superseded queued builds since August 2026). Meanwhile, Worker Previews (September 2026) now cover the per-PR preview URLs that used to be a Pages selling point ## References - Pages home: https://pages.cloudflare.com/ - Documentation: https://developers.cloudflare.com/pages/ - Limits: https://developers.cloudflare.com/pages/platform/limits/ - Changelog, 100,000 files on paid plans (2026-01-23): https://developers.cloudflare.com/changelog/post/2026-01-23-pages-file-limit-increase/ - Changelog, Worker Previews (2026-09-22): https://developers.cloudflare.com/changelog/post/2026-09-22-worker-previews/ - Workers vs Pages: https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/ ## Related - [[Cloudflare]] - [[Cloudflare Workers]] - [[Cloudflare R2]] - [[Wrangler]] - [[Edge Computing]] - [[GitHub Pages]] - [[Vercel]] - [[Git]] - [[PKM AI Wiki]] - [[AI Wiki Template]]