# 010116 I18N Patterns

> Internationalization — translation tables, RTL support, safe translations, LangProvider, locale detection, SEO hreflang, and language config.

- Skill: `natuleadan/010116-i18n-patterns` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add natuleadan/010116-i18n-patterns`
- Raw SKILL.md: https://api.skillmd.com/api/skills/natuleadan/010116-i18n-patterns/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- License: MIT
- Author: natuleadan (https://skillmd.com/u/natuleadan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/natuleadan/010116-i18n-patterns

---


# Internationalization (i18n)

## Overview

Patterns for building multilingual applications with RTL support, safe translation rendering, and server-side language detection.

## Quick Reference

### Language Detection
- Language determined server-side (middleware or database)
- Propagated to clients via `LangProvider` in layout
- Database `languages.direction` is source of truth for RTL

### Safe Translation
```typescript
const { getT } = useSafeTranslation(translations);
return <h1>{getT('page.title')}</h1>;
```

### RTL Support
- Automatic detection via `LangService`
- `dir="rtl"` on HTML element
- Tailwind respects RTL direction
- ARIA text in English unless translation key exists

## References

| Topic | File |
|---|---|
| RTL support, safe translations, LangProvider, language tables | [references/i18n-patterns.md](references/i18n-patterns.md) |
| CSS logical properties, DirectionProvider, icon rotation, RTL pitfalls | [references/rtl-css-patterns.md](references/rtl-css-patterns.md) |
| Per-entity translation table pattern (product_translations, etc.) | [references/per-entity-translations.md](references/per-entity-translations.md) |
| Translation assembler pattern (fetch all, filter in-memory) | [references/assembler-pattern.md](references/assembler-pattern.md) |
| Server-side locale detection in proxy.ts | [references/server-locale-detection.md](references/server-locale-detection.md) |
| SEO hreflang alternates for multi-language sites | [references/seo-hreflang.md](references/seo-hreflang.md) |