Voltar ao índice
Desenvolvimento web Fonte oficial

Adicionar idioma com next-intl no Next.js

Orienta a inclusão completa de um idioma em projeto Next.js com next-intl, cobrindo mensagens, rotas, middleware e seletor.

Ver código no GitHub Instala diretamente do repositório-fonte.

O que esta skill faz

Esta skill descreve um fluxo específico para aplicações que armazenam traduções em `./messages` e usam next-intl. A inclusão envolve traduzir todas as entradas de `en.json` e atualizar routing, middleware e o componente de seleção de idioma.

Quando usar

  • Adicionar um novo locale à aplicação
  • Criar um arquivo de mensagens a partir de en.json
  • Expor o idioma no seletor da interface
  • Atualizar rotas internacionalizadas
  • Manter middleware alinhado aos locales disponíveis

Como usar

  1. Revise o repositório e confirme que ele segue os caminhos descritos
  2. Traduza todas as entradas de en.json para o novo arquivo
  3. Adicione o locale em src/i18n/routing.ts
  4. Atualize src/middleware.ts e language-toggle.tsx
  5. Teste navegação, seleção e cobertura das mensagens

O que revisar antes de instalar

  • As instruções pressupõem caminhos específicos do projeto
  • A qualidade e a precisão da tradução exigem revisão humana
  • A skill não descreve fallback, pluralização ou formatação regional

SKILL.md

---
name: next-intl-add-language
description: 'Add new language to a Next.js + next-intl application'
---

This is a guide to add a new language to a Next.js project using next-intl for internationalization,

- For i18n, the application uses next-intl.
- All translations are in the directory `./messages`.
- The UI component is `src/components/language-toggle.tsx`.
- Routing and middleware configuration are handled in:
  - `src/i18n/routing.ts`
  - `src/middleware.ts`

When adding a new language:

- Translate all the content of `en.json` to the new language. The goal is to have all the JSON entries in the new language for a complete translation.
- Add the path in `routing.ts` and `middleware.ts`.
- Add the language to `language-toggle.tsx`.