next-intl
Cách dùng next-intl trong Next.js 16 App Router của repo này(越南语 UI、服务器/客户端模式、区域设置路由)。
📖 中文导读:Cách dùng next-intl trong Next.js 16 App Router của repo này(越南语 UI、服务器/客户端模式、区域设置路由)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: next-intl description: Cách dùng next-intl trong Next.js 16 App Router của repo này (Vietnamese UI, server/client patterns, locale routing).
Nguồn trong repo
- Request config (merge messages + fallback):
apps/web/src/i18n/request.ts - Locale messages:
apps/web/src/i18n/locales/*.json(ưu tiênvi.json) - Usage examples: nhiều components dùng
getTranslations/useTranslations.
Quy tắc bắt buộc
- UI text phải tiếng Việt qua
next-intl(không hardcode English strings). - Next.js 16: luôn
await paramsvàawait searchParamstrong pages.
Server vs Client
Server Components
- Dùng
getTranslations('namespace'):const t = await getTranslations('site')
- Nếu cần locale cụ thể:
getTranslations({ locale, namespace })(đã có pattern trong repo).
Client Components
- Dùng
useTranslations('namespace')và/hoặcuseLocale(). - Chỉ thêm
'use client'khi có state/effect/event handlers.
Messages loading
request.tsmerge fallback messages từ default locale + locale hiện tại.- Khi thêm key mới, update
apps/web/src/i18n/locales/vi.json(và locale khác nếu có).
Routing
- Locale list/config nằm ở config/routing (được import trong
request.ts). - Khi tạo route mới dưới
app/[locale]/..., đảm bảo text UI qua i18n.