localization-design

Design UI layouts that adapt to text expansion, RTL scripts, and locale-specific formats.

2.5k|358|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Owl-Listener/designer-skills --skill localization-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: localization-design
Source: https://github.com/Owl-Listener/designer-skills/tree/main/design-systems/skills/localization-design
Command: npx skills add https://github.com/Owl-Listener/designer-skills --skill localization-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interfaces designed only for English break when translated: text overflows containers, layouts fail in right-to-left languages, and colors or icons carry unintended cultural meanings. This Skill provides the design rules to build components that survive any locale without per-language redesigns.

Core Features & Use Cases

  • Text Expansion Planning: Apply language-specific expansion factors (German +20–35%, Finnish +30–40%) with flexible containers, min-width buttons, and truncation fallbacks.
  • RTL Layout Support: Mirror layouts, directional icons, and navigation for Arabic, Hebrew, Persian, and Urdu using CSS logical properties like margin-inline-start and text-align: start.
  • Cultural & Locale Adaptation: Account for color semantics, iconography taboos, and locale-aware date, currency, and address formats via Intl APIs.
  • Use Case: Before shipping a checkout flow to Germany and Saudi Arabia, validate that buttons handle 35% text expansion, the layout mirrors correctly in RTL, and date fields use locale-aware formatting.

Quick Start

Review this checkout page design for localization readiness, checking text expansion tolerance, RTL mirroring, and locale-specific formats.

Frequently Asked Questions about localization-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design UI for text expansion in translation?

Use flexible heights and widths instead of fixed containers sized to English copy. Test layouts with German or Finnish as worst-case proxies, apply min-width rather than fixed width on buttons, and use truncation with tooltips only as a last resort.

How do I support RTL languages like Arabic in CSS?

Use CSS logical properties such as margin-inline-start and padding-block-end instead of directional ones like margin-left, and set text-align: start. These flip automatically when dir="rtl" is applied, mirroring the layout without duplicate stylesheets.

What should not be mirrored in RTL layouts?

Logos, brand marks, clocks, mathematical notation, and most images stay unmirrored in RTL. Numerals also remain left-to-right within RTL text. Only directional icons like arrows and chevrons should flip; neutral icons like cameras do not.

Does color meaning change across cultures in UI design?

Yes. Red signals luck in China but danger in Western contexts, and white signifies mourning in many East Asian cultures. Never rely on color alone for semantic meaning, and validate palettes with cultural consultants for global products.

How do I test localization before translations exist?

Use pseudo-localization, which replaces characters with extended lookalikes to simulate expansion and special character handling. Also test components with at least one RTL locale and one long-expansion locale before adding them to a design system.