CSS
O Next.js oferece várias formas de estilizar seu app usando CSS, incluindo:
Tailwind CSS
O Tailwind CSS é um framework CSS utility-first que oferece classes utilitárias de baixo nível para criar designs personalizados.
Instale o Tailwind CSS:
pnpm add -D tailwindcss @tailwindcss/postcssnpm install -D tailwindcss @tailwindcss/postcssyarn add -D tailwindcss @tailwindcss/postcssbun add -D tailwindcss @tailwindcss/postcssAdicione o plugin do PostCSS ao seu arquivo postcss.config.mjs:
export default {
plugins: {
'@tailwindcss/postcss': {},
},
}Importe o Tailwind no seu arquivo CSS global:
@import 'tailwindcss';Importe o arquivo CSS no seu layout raiz:
import './globals.css'
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}import './globals.css'
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}Agora você já pode usar as classes utilitárias do Tailwind no seu app:
export default function Page() {
return (
<main className="flex min-h-screen flex-col items-center justify-between p-24">
<h1 className="text-4xl font-bold">Welcome to Next.js!</h1>
</main>
)
}export default function Page() {
return (
<main className="flex min-h-screen flex-col items-center justify-between p-24">
<h1 className="text-4xl font-bold">Welcome to Next.js!</h1>
</main>
)
}Bom saber: se você precisar de suporte a navegadores muito antigos, veja as instruções de configuração do Tailwind CSS v3.
CSS Modules
Os CSS Modules limitam o escopo do CSS localmente, gerando nomes de classes únicos. Isso permite usar a mesma classe em arquivos diferentes sem se preocupar com colisões de nomes.
Para começar a usar CSS Modules, crie um novo arquivo com a extensão .module.css e importe-o em qualquer componente dentro do diretório app:
.blog {
padding: 24px;
}import styles from './blog.module.css'
export default function Page() {
return <main className={styles.blog}></main>
}import styles from './blog.module.css'
export default function Page() {
return <main className={styles.blog}></main>
}CSS global
Você pode usar CSS global para aplicar estilos em todo o seu app.
Crie um arquivo app/global.css e importe-o no layout raiz para aplicar os estilos a todas as rotas do seu app:
body {
padding: 20px 20px 60px;
max-width: 680px;
margin: 0 auto;
}// These styles apply to every route in the application
import './global.css'
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}// These styles apply to every route in the application
import './global.css'
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>{children}</body>
</html>
)
}Bom saber: estilos globais podem ser importados em qualquer layout, página ou componente dentro do diretório
app. No entanto, como o Next.js usa o suporte nativo do React a folhas de estilo para integrar com o Suspense, atualmente isso não remove as folhas de estilo ao navegar entre rotas, o que pode gerar conflitos. Recomendamos usar estilos globais apenas para CSS realmente global (como os estilos base do Tailwind), o Tailwind CSS para estilizar componentes e os CSS Modules para CSS com escopo próprio, quando necessário.
Folhas de estilo externas
Folhas de estilo publicadas por pacotes externos podem ser importadas em qualquer lugar do diretório app, inclusive em componentes que ficam na mesma pasta:
import 'bootstrap/dist/css/bootstrap.css'
export default function RootLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body className="container">{children}</body>
</html>
)
}import 'bootstrap/dist/css/bootstrap.css'
export default function RootLayout({ children }) {
return (
<html lang="en">
<body className="container">{children}</body>
</html>
)
}Bom saber: no React 19, também é possível usar
<link rel="stylesheet" href="..." />. Veja a documentação dolinkno React para mais informações.
Ordem e mesclagem
O Next.js otimiza o CSS nos builds de produção dividindo (mesclando) automaticamente as folhas de estilo em partes. A ordem do seu CSS depende da ordem em que você importa os estilos no código.
Por exemplo, base-button.module.css vai ficar antes de page.module.css, já que <BaseButton> é importado antes de page.module.css:
import { BaseButton } from './base-button'
import styles from './page.module.css'
export default function Page() {
return <BaseButton className={styles.primary} />
}import { BaseButton } from './base-button'
import styles from './page.module.css'
export default function Page() {
return <BaseButton className={styles.primary} />
}import styles from './base-button.module.css'
export function BaseButton() {
return <button className={styles.primary} />
}import styles from './base-button.module.css'
export function BaseButton() {
return <button className={styles.primary} />
}Recomendações
Para manter a ordem do CSS previsível:
- Tente concentrar as importações de CSS em um único arquivo de entrada JavaScript ou TypeScript
- Importe estilos globais e folhas do Tailwind na raiz do seu app.
- Use o Tailwind CSS para a maioria das necessidades de estilo, já que ele cobre padrões de design comuns com classes utilitárias.
- Use CSS Modules para estilos específicos de componentes quando as classes utilitárias do Tailwind não forem suficientes.
- Adote uma convenção de nomes consistente para os seus CSS Modules. Por exemplo, use
<name>.module.cssem vez de<name>.tsx. - Extraia estilos compartilhados para componentes compartilhados, evitando importações duplicadas.
- Desative linters ou formatadores que ordenam importações automaticamente, como a regra
sort-importsdo ESLint. - Você pode usar a opção
cssChunkingnonext.config.jspara controlar como o CSS é dividido.
Desenvolvimento e produção
- Em desenvolvimento (
next dev), as alterações de CSS são aplicadas na hora, com o Fast Refresh. - Em produção (
next build), todos os arquivos CSS são automaticamente concatenados em vários arquivos.cssminificados e divididos por rota (code-split), garantindo que a menor quantidade possível de CSS seja carregada para cada rota. - O CSS continua sendo carregado em produção mesmo com o JavaScript desativado, mas em desenvolvimento o JavaScript é necessário para o Fast Refresh.
- A ordem do CSS pode se comportar de forma diferente em desenvolvimento. Sempre confira o build (
next build) para verificar a ordem final do CSS.
Próximos passos
Saiba mais sobre as alternativas para usar CSS no seu app.