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.
Primeira dobra com CTA e imagem editável
Biografia com layout flex
Array de serviços com ícones
Grid de projetos com filtro
Carrossel de clientes
Posts com Lexical + formulário
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
| Tecnologia | Versão | Uso |
|---|---|---|
| Next.js | 16.3.5 | Framework + Turbopack |
| Payload CMS | 3.x | CMS Headless |
| TypeScript | 5.x | Tipagem total |
| Tailwind CSS | 4.x | Estilizaçã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/