Configuração Next.js

Configure App Router, CSS Modules, alias @ e evite o erro de CSS que não aplica

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.