Introdução

Visão geral do projeto - o que vamos construir, por que Payload + Next.js e como usar esta documentação

Bem-vindo à documentação completa para construir um portfólio profissional, editável e performático usando Payload CMS 3.0 + Next.js 15 + TypeScript.

Essa documentação nasceu de problemas reais: erros de importação de Blocks, CSS que não aplicava, e falta de conteúdo em português sobre Payload.

O que vamos construir

Um site de portfólio completo com 7 blocos editáveis pelo cliente no painel do Payload.

Para quem é esta documentação?:

Para devs que já sabem React/Next básico e querem sair do WordPress/ACF. Se você já tomou Module not found: Can't resolve '../../blocks/ContatoBlock', você está no lugar certo.

Por que Payload + Next.js?

  • Tudo é TypeScript: Collections e Blocks geram tipos automaticamente
  • Sem lock-in: Você controla o banco
  • Blocks nativos: Perfeito para page builder como SobreBlock, ServicosBlock

Stack final

TecnologiaVersãoUso
Next.js16.3.5Framework + Turbopack
Payload CMS3.xCMS Headless
TypeScript5.xTipagem total
Tailwind CSS4.xEstilização
MongoDB / Postgres-Banco

Estrutura que vamos criar

src/
├── blocks/
│   ├── SobreBlock/
│   │   ├── config.ts
│   │   ├── Component.tsx
│   │   └── styles.module.css
│   └── RenderBlocks.tsx
├── collections/
│   ├── Pages.ts
│   └── Media.ts
└── payload.config.ts

contents/docs/portfolio/
├── 01-introducao/
└── 02-instalacao-payload/