Vamos criar o projeto do portfólio do zero. No final você terá o Payload em /admin e o Next em /.
Pré-requisitos
| Item | Versão mínima | Como verificar |
|---|---|---|
| Node.js | 20.9+ | node -v |
| npm | 10+ | npm -v |
| Banco | MongoDB Atlas ou Postgres | Vamos criar agora |
Qual banco usar?:
Para portfólio recomendo MongoDB Atlas (gratuito) para começar rápido. Para produção use Postgres (Neon/Supabase).
Passo 1 - Criar o projeto
npx create-payload-app@latest meu-portfolio -t website
cd meu-portfolio
npm run dev
Selecione:
- Database: MongoDB
- Template: website
Passo 2 - Configure o .env
Crie o arquivo .env na raiz:
PAYLOAD_SECRET=seu-secret-super-seguro-aqui-32chars
DATABASE_URI=mongodb+srv://usuario:senha@cluster.mongodb.net/meu-portfolio
NEXT_PUBLIC_SERVER_URL=http://localhost:3000
Passo 3 - Primeiro acesso
npm run dev
Abra http://localhost:3000/admin e crie seu primeiro usuário.
Passo 4 - Ajustar o payload.config.ts
Esse arquivo causa 90% dos erros Module not found. Use alias absoluto @/.
// src/payload.config.ts
import { buildConfig } from 'payload'
import { mongooseAdapter } from '@payloadcms/db-mongodb'
import { lexicalEditor } from '@payloadcms/richtext-lexical'
import path from 'path'
import { fileURLToPath } from 'url'
const filename = fileURLToPath(import.meta.url)
const dirname = path.dirname(filename)
export default buildConfig({
secret: process.env.PAYLOAD_SECRET!,
db: mongooseAdapter({
url: process.env.DATABASE_URI!,
}),
editor: lexicalEditor({}),
collections: [],
typescript: {
outputFile: path.resolve(dirname, 'payload-types.ts'),
},
})
Erro comum:
Nunca use ../../blocks/ContatoBlock. Sempre use @/blocks/ContatoBlock/config.
Passo 5 - Estrutura inicial
src/
├── blocks/
│ ├── HomeBlock/
│ ├── SobreBlock/
│ ├── ServicosBlock/
│ ├── TrabalhosBlock/
│ ├── DepoimentosBlock/
│ ├── BlogBlock/
│ └── ContatoBlock/
├── collections/
│ ├── Pages.ts
│ └── Media.ts
└── payload.config.ts
Validação
npm run generate:types
npm run build
Checkpoint:
Ao final você deve conseguir acessar:
- http://localhost:3000 = Site vazio
- http://localhost:3000/admin = Painel do Payload