Internationalization for Next.js.
Internationalization (i18n) is an essential part of the user experience, therefore next-intl gives you all the parts you need to get language nuances right.
- π ICU message syntax: Localize your messages with interpolation, cardinal & ordinal plurals, enum-based label selection and rich text.
- π Dates, times & numbers: Apply appropriate formatting without worrying about server/client differences like time zones.
- β Type-safe: Speed up development with autocompletion for message keys and catch typos early with compile-time checks.
- π‘ Hooks-based API: Learn a single API that can be used across your code base to turn translations into plain strings or rich text.
- π Next.js-native and performance-obsessed: App Router, Server Components, static renderingβpick the right tool for the right job, next-intl works everywhere.
- π Internationalized routing: Provide unique pathnames per language and optionally localize pathnames for search engine optimization.
// UserProfile.tsx
import {useTranslations} from 'next-intl';
export default function UserProfile({user}) {
const t = useTranslations('UserProfile');
return (
<section>
<h1>{t('title', {firstName: user.firstName})}</h1>
<p>{t('membership', {memberSince: user.memberSince})}</p>
<p>{t('followers', {count: user.numFollowers})}</p>
</section>
);
}// en.json
{
"UserProfile": {
"title": "{firstName}'s profile",
"membership": "Member since {memberSince, date, short}",
"followers": "{count, plural, β΅
=0 {No followers yet} β΅
=1 {One follower} β΅
other {# followers} β΅
}"
}
}As an app grows, messages may drift and become inconsistent.
A companion tool, eloqnt/cli, catches this by analyzing your source code and messages statically:
$ eloqnt lint
messages/de.json
β
β "UserProfile.title": "Dein Profil"
β ββ¬ββββββββββ
β β°β Inconsistent ICU arguments: missing {firstName} (inconsistent-args)
β
β "UserProfile.membership": "Member since {memberSince, date, short}"
β ββ¬ββββββββββββββββββββββ
β β°β Missing translation for de (missing-translation)
β 1 error
! 1 warning
β Rule details: https://cli.eloqnt.dev/docs/lint-rules/<rule>
β Run `eloqnt translate` to fill in 1 missing translationIt can optionally also fill in missing translations with eloqnt translate, using your source code as context.