O Payload já vem com Next.js, mas precisamos ajustar 3 coisas que quebram 90% dos projetos de portfólio.
O Problema Real
Erro que você já viu:
import './styles.css' não aplica nada, ou Module not found: @/blocks/... no build.
1. Alias @/
No tsconfig.json:
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["./src/*"],
"@/payload-types": ["./src/payload-types.ts"]
}
}
}
1
1
Crie src/blocks/test.ts e importe em payload.config.ts com @/blocks/test. Se não der erro, o alias funciona.
2
1
No VSCode: Ctrl+Shift+P -> Restart TS Server. Isso evita falso erro vermelho.
2. CSS Modules vs Global
O Next 15 com Turbopack ignora CSS global dentro de blocks/. Use sempre CSS Modules.
- Component.tsx
- config.ts
- styles.module.css
// Component.tsx - CERTO
import styles from './styles.module.css'
export const SobreBlock = () => <section className={styles.wrapper}>...
// ERRADO - não vai aplicar
import './styles.css'
.wrapper {
padding: 4rem 0;
display: grid;
gap: 2rem;
}
3. next.config.ts essencial
import { withPayload } from '@payloadcms/next/withPayload'
const nextConfig = {
// necessário para Payload 3.0
experimental: {
reactCompiler: false,
},
}
export default withPayload(nextConfig)
Checkpoint:
Rode npm run build. Se passar sem erro de CSS ou alias, pode ir para o próximo.