Cloudflare Pages

O que é

Cloudflare Pages é uma plataforma de hospedagem para sites — de arquivos estáticos simples a aplicações full-stack completas. Você conecta um repositório (a pasta online onde vive o histórico do seu código), o Pages executa seu comando de build e serve o resultado pela CDN da Cloudflare (Content Delivery Network — Rede de Distribuição de Conteúdo — um conjunto mundial de servidores que mantêm cópias dos seus arquivos perto de cada visitante). Rotas dinâmicas e APIs (Application Programming Interfaces — Interfaces de Programação de Aplicações — os pontos de acesso que outros softwares chamam para conversar com sua aplicação) rodam como Pages Functions, que por baixo dos panos são Workers. Ou seja, um único projeto pode ser ao mesmo tempo um site estático e um .

Pontos fortes

Orientado a Git: cada push gera um build e um , com uma de preview por .
Os arquivos estáticos são servidos rápido e de graça pela CDN global.
As Pages Functions adicionam lógica do lado do servidor com as mesmas bindings (conexões prontas) dos Workers — D1 (um banco de dados ), R2 (armazenamento de arquivos), KV (um armazenamento chave-valor, como um dicionário gigante de rótulo-para-valor).
Camada gratuita generosa e banda ilimitada.
Rollbacks são de um clique — todo deploy fica preservado.

Contrapartidas

O ambiente de build tem limites de tempo e recursos; builds muito grandes podem ficar lentos.
As Functions herdam o runtime dos Workers, então valem as mesmas restrições de não usar Node.
Para backends puramente dinâmicos e sempre ativos, Workers puros podem ser um encaixe mais limpo.
A configuração de build para frameworks menos comuns às vezes exige ajuste manual.

Quando usar

Use o Pages para sites institucionais, documentação, blogs, SPAs (single-page apps — aplicações de página única — sites que carregam uma vez e se atualizam no lugar sem recarregar a página inteira) e frameworks full-stack (Next.js, Astro, SvelteKit) quando você quer deploys baseados em Git, hospedagem estática gratuita e funções de servidor opcionais, tudo em um só lugar.

Encaixe com vibe coding

O Pages combina bem com vibe coding porque o deploy inteiro se resume a "conectar um repositório e dar push". Um agente pode configurar o comando de build, o diretório de saída e as variáveis de ambiente, e depois publicar com o Wrangler ou disparar um build via Git. Dica: diga ao agente qual você está usando e se precisa de Functions, para que ele escolha o adaptador e o diretório de saída corretos. Você também pode publicar um diretório já compilado diretamente.

# wrangler.toml — Pages project config
name = "my-site"
pages_build_output_dir = "dist"

[[d1_databases]]
binding = "DB"
database_name = "my-db"
database_id = "your-d1-id"

# Deploy a prebuilt output directory
npx wrangler pages deploy dist --project-name my-site