i18n-best-practices
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-03-27
- Stars
- ★ 3
- Forks
- 1
02 资源文件 2
- 参考文档example.html7.1 KB
- 参考文档example.md823 B
03 SKILL.md 正文
Internationalization (i18n) Best Practices
Library Choice
- next-intl: Recommended for Next.js App Router (RSC-compatible, type-safe)
- react-intl: ICU MessageFormat, good for complex plurals/gender
- i18next + react-i18next: Framework-agnostic, largest ecosystem
Next.js App Router Setup (next-intl)
src/
i18n/
request.ts # getRequestConfig()
routing.ts # defineRouting({ locales, defaultLocale })
messages/
en.json
ko.json
middleware.ts # createMiddleware(routing)
app/
[locale]/
layout.tsx # NextIntlClientProvider
page.tsx # useTranslations('namespace')
Key Patterns
- Namespace separation: Group by feature (
auth.login,dashboard.title) - Type-safe keys: Generate types from default locale JSON
- Pluralization: Use ICU format
{count, plural, one {# item} other {# items}} - Date/Number formatting: Use
useFormatter()(next-intl) orIntlAPI, never manual formatting - Server Components:
getTranslations()in RSC,useTranslations()in client - Dynamic messages: Avoid string concatenation; use interpolation
t('greeting', { name })
Common Mistakes
- Hardcoded strings in components (use extraction tools:
i18n-allyVSCode extension) - Locale in URL path AND cookie (pick one strategy)
- Missing fallback locale handling
- Not accounting for text expansion (German ~30% longer than English)
- Date/currency formatting without locale context
04 同仓库更多 Skills
zustand
Zustand state management guide. Use when working with store code (src/store/**), implementing actions, managing state, or creating slices. Triggers on Zustand store development, state management questions, or action implementation.
web-vitals
暂无简介
vercel-storage
Vercel storage expert guidance — Blob, Edge Config, and Marketplace storage (Neon Postgres, Upstash Redis). Use when choosing, configuring, or using data storage with Vercel applications.
vercel-functions
Vercel Functions expert guidance — Serverless Functions, Edge Functions, Fluid Compute, streaming, Cron Jobs, and runtime configuration. Use when configuring, debugging, or optimizing server-side code running on Vercel.
ui-ux-pro-max
UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, and flat design. Topics: color systems, accessibility, animation, layout, typography, font pairing, spacing, interaction states, shadow, and gradient. Integrations: shadcn/ui MCP for component search and examples.
turborepo
Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines, dependsOn, caching, remote cache, the "turbo" CLI, --filter, --affected, CI optimization, environment variables, internal packages, monorepo structure/best practices, and boundaries. Use when user: configures tasks/workflows/pipelines, creates packages, sets up monorepo, shares code between apps, runs changed/affected packages, debugs cache, or has apps/packages directories.