AGENT SKILL

i18n-best-practices

暂无简介

License 许可
MIT
最近更新
2026-03-27
Stars
★ 3
Forks
1

02 资源文件 2

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) or Intl API, 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-ally VSCode 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

ByeongminLee
ByeongminLee/nextjs-claude-code

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.

★ 3
ByeongminLee
ByeongminLee/nextjs-claude-code

web-vitals

暂无简介

★ 3
ByeongminLee
ByeongminLee/nextjs-claude-code

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.

后端与接口
★ 3
ByeongminLee
ByeongminLee/nextjs-claude-code

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.

开发工程师后端与接口
★ 3
ByeongminLee
ByeongminLee/nextjs-claude-code

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.

设计师数据分析师前端开发视觉设计
★ 3
ByeongminLee
ByeongminLee/nextjs-claude-code

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.

★ 3