Communitygithub.com

Internationalisierungs-Design-System (i18n)

Entwerfen Sie ein systematisches Framework für global einsetzbare Oberflächen, das bidirektionale (RTL) Layouts, lokalisierte Typografie und kulturelle Ikonografie adressiert, um ein nahtloses Erlebnis über Sprachen und Regionen hinweg zu gewährleisten.

Was ist Internationalisierungs-Design-System (i18n)?

Diese Fähigkeit bietet eine methodische Anleitung zur Gestaltung von Benutzeroberflächen, die von Grund auf für internationale Nutzer geeignet sind. Sie geht über die reine Übersetzung hinaus und behandelt räumliche Anpassungen, Typografie für nicht-lateinische Schriften, kulturell angemessene Ikonografie sowie die korrekte Umsetzung von bidirektionalen Layouts (RTL). Das System ist besonders nützlich für Entwickler, die plattformübergreifend arbeiten (z. B. mit Claude Code, Cursor, Codex oder ähnlichen KI-Agenten), da es klare Designentscheidungen und Prüfkriterien liefert. Es basiert auf bewährten Praktiken wie der Verwendung von logischen CSS-Eigenschaften (Start/End anstelle von Left/Right), einem 35 %-Puffer für Texterweiterung und spezifischen Schriftgrößenanpassungen für komplexe Schriften wie Devanagari oder CJK. Der Workflow umfasst fünf Schritte: Design für Texterweiterung, Implementierung von RTL-Spiegelungslogik, Lokalisierung von Typografie, Audit der Ikonenrichtungsabhängigkeit und Festlegung von Datenformatierungsstandards.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/internationalization-design-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Internationalisierungs-Design-System

Zweck

Die Fähigkeit des Internationalisierungs-Design-Systems (i18n) bietet eine Methodik für die Gestaltung von Oberflächen, die für ein globales Publikum bereit sind. Sie geht über die einfache Übersetzung hinaus und adressiert die räumlichen, typografischen und visuellen Auswirkungen verschiedener Sprachen und Kulturen. Dieses System stellt sicher, dass Layouts flexibel genug sind, um unterschiedliche Textlängen aufzunehmen, dass bidirektionale (Rechts-nach-Links) Layouts korrekt gespiegelt werden und dass visuelle Hinweise kulturell angemessen bleiben.

Anwendungsfälle

  • Entwurf einer globalen SaaS-Plattform oder einer E-Commerce-Website für die regionale Veröffentlichung.
  • Anpassung einer bestehenden englischsprachigen Oberfläche für RTL-Sprachen (Arabisch, Hebräisch, Persisch).
  • Festlegung typografischer Standards für nicht-lateinische Schriften (CJK, Kyrillisch, Devanagari).
  • Überprüfung von UI-Komponenten auf „Expansion-Readiness“ (Umgang mit Textwachstum in Deutsch oder Finnisch).
  • Erstellung von Iconsets, die kulturell spezifische oder richtungsbezogene Verzerrungen vermeiden.

Wann NICHT zu verwenden

  • Single-Region/Single-Language-Seiten: Wo es keinen Plan für zukünftige Erweiterungen gibt und lokale Konventionen streng bekannt sind.
  • Reine visuelle narrative Seiten: Wo das Design ein künstlerischer Ausdruck ist, der auf festen, nicht umfließenden räumlichen Beziehungen beruht.
  • Nur-Inhaltsübersetzung: Wenn die Aufgabe lediglich das Übersetzen von Texten ohne Änderung der UI oder des Layoutverhaltens ist.

Eingaben

  1. Liste der Zielsprachen: Welche Sprachen und Schriften sollen unterstützt werden?
  2. Leserichtung: Fließt die Sprache von links nach rechts (LTR) oder von rechts nach links (RTL)?
  3. Typografie-Assets: Lokalisierte Schriftfamilien, die die Stimme der Marke über alle Schriften hinweg bewahren.
  4. Kultureller Kontext: Regionalspezifische Konventionen für Farben, Symbole und Datenformate (Datum, Währung).
  5. Layout-Breakpoints: Aus dem responsive-grid-system.

Ausgaben

  1. Bidirektionale (RTL) Spiegelungsspezifikation: Eine Karte, welche Elemente gespiegelt werden und welche fest bleiben (z. B. Fortschrittsbalken vs. Mediensteuerung).
  2. Typografische Skalierungsmatrix: Angepasste Schriftgrößen und Zeilenhöhen für verschiedene Schriftfamilien.
  3. Expansions-Blueprint: UI-Muster, die für eine Textlängenvariation von +/- 40 % ausgelegt sind.
  4. Ikonografie-Logik: Richtlinien für gespiegelte vs. nicht gespiegelte Icons.
  5. Lokalisierungs-Design-Tokens: Logische Eigenschaften (z. B. padding-inline-start), die im Design-Spezifikation definiert sind.

Arbeitsablauf

1. Design für Texterweiterung

Gehen Sie nie davon aus, dass ein Label kurz bleibt. Sprachen wie Deutsch oder Italienisch können 30-50 % länger sein als Englisch.

  • Flexible Container: Vermeiden Sie Buttons oder Karten mit fester Breite; verwenden Sie min-width oder fit-content.
  • Textumbruch: Stellen Sie sicher, dass UI-Elemente (wie Tabs oder Menüpunkte) elegant umbrechen oder zu einem „Überlauf“-Menü übergehen können.
  • Dynamische Zentrierung: Wenn Text expandiert, stellen Sie sicher, dass er nicht mit benachbarten Elementen überlappt.

2. Implementierung der RTL-Spiegelungslogik

Bei rechts-nach-links-Sprachen kippt das „mentale Modell“ der Seite:

  • Layout-Spiegelung: Die Seitenleiste bewegt sich von links nach rechts; das Logo bewegt sich von oben links nach oben rechts.
  • Logische Eigenschaften: Annotieren Sie Designs mit „Start“ und „Ende“ anstelle von „Links“ und „Rechts“.
  • Navigationsfluss: Zurück-Buttons in LTR (die nach links zeigen) müssen in RTL nach rechts zeigen, um „Zurück zum vorherigen Zustand“ anzuzeigen.

3. Lokalisierung von Typografie und vertikalem Rhythmus

Nicht-lateinische Schriften haben unterschiedliche Höhen, Dichten und Lesbarkeitsanforderungen:

  • CJK (Chinesisch, Japanisch, Koreanisch): Benötigt etwas größere Basisschriftgrößen und großzügigere Zeilenhöhe (Leading) aufgrund der Zeichenkomplexität.
  • Arabisch: Hat hohe Oberlängen und tiefe Unterlängen; erhöhen Sie den vertikalen Abstand, um ein „Aneinanderstoßen“ der Zeilen zu verhindern.
  • Fallback-Stapel: Definieren Sie System-Schrift-Fallbacks, die der Gewichtung und x-Höhe Ihrer primären Markenschrift so genau wie möglich entsprechen.

4. Überprüfung der Ikonenrichtungsabhängigkeit

Nicht alles wird in RTL gespiegelt:

  • Spiegeln: Richtungsicons (Pfeile, Flugzeuge, Fahrräder), Fortschrittsbalken und Icons, die „vorwärts/rückwärts“-Bewegung darstellen.
  • Nicht spiegeln: Im oder gegen den Uhrzeigersinn drehende Icons (Uhren, neu laden), Medienwiedergabesteuerung (Play, Pause, Suchen) und „Häkchen“ (die universell sind).
  • Zahlen: Die meisten RTL-Regionen verwenden westliche arabische Ziffern (1, 2, 3), die auch innerhalb von RTL-Text immer noch von links nach rechts gelesen werden.

5. Festlegung von Datenformatierungsstandards

  • Datum & Uhrzeit: Definieren Sie eindeutig DD/MM/YYYY vs. MM/DD/YYYY, um Verwirrung zu vermeiden.
  • Währung: Definieren Sie, ob das Symbol vor oder nach dem Betrag steht (z. B. $10 vs. 10 €).
  • Kalender: Einige Regionen verwenden unterschiedliche Starttage der Woche (Montag vs. Sonntag).

Entscheidungsregeln

  • Die Spiegelungsregel: Wenn ein UI-Element „Richtung“ oder „Zeit“ (vorwärts bewegen) darstellt, MUSS es in RTL gespiegelt werden. Wenn es ein physisches Objekt darstellt (wie eine Kamera oder eine Uhr), bleibt es normalerweise fest.
  • Die „35 % Puffer“-Regel: Lassen Sie während der englischen Designphase immer 35 % leeren Raum in Buttons und Labels, um Expansion zu berücksichtigen.
  • Schriftspezifische Größenanpassung: Wenn eine Schrift hochkomplex ist (z. B. Devanagari), erhöhen Sie die Schriftgröße um 10-15 % im Vergleich zum lateinischen Äquivalent für eine bessere Lesbarkeit.
  • Kulturelle Sensibilität: Vermeiden Sie Icons, die westlich zentriert sind (z. B. ein Sparschwein für Ersparnisse, das in vielen Kulturen unangemessen ist).

Einschränkungen

  • Barrierefreiheit: Texterweiterung darf interaktive Elemente nicht verbergen oder horizontalen Überlauf verursachen. Kontrastverhältnisse müssen in allen lokalisierten Versionen erhalten bleiben.
  • Responsivität: Layouts müssen stabil bleiben, wenn die Richtung gewechselt wird. Verwenden Sie padding-inline und margin-inline in den Spezifikationen.
  • Hierarchie: Der primäre CTA muss unabhängig von der Leserichtung das markanteste Element bleiben.

Häufige Fehlermuster

  • Der „Expansion Break“: Hartcodierte Breiten, die dazu führen, dass übersetzter Text abgeschnitten wird oder überlappt.
  • „Lazy Mirroring“: Das Spiegeln von Icons, die nicht gespiegelt werden sollten (wie ein „Play“-Button oder eine Uhr), was die Benutzer verwirrt.
  • Die „English-First“-Falle: Entwurf einer engen, minimalistischen UI auf Englisch, die in Sprachen mit langen Wörtern völlig unbenutzbar wird.
  • Fehlende Fallbacks: Keine Angabe von Schriftarten für nicht-lateinische Schriften, was zu „Tofu“ (kaputten Zeichenblöcken) führt.
  • Inkonsistente Ausrichtung: Mischen von gespiegeltem Layout mit ungespiegelter Textausrichtung, was ein zerklüftetes, unfertiges Gefühl erzeugt.

Validierungskriterien

  • Layout ist für RTL-Ansichtsfenster erfolgreich gespiegelt (Sidebar/Logo-Tausch).
  • UI-Komponenten verarbeiten 40 % Texterweiterung ohne Bruch oder Überlappung.
  • Typografische Skalierung ist an die Schreibkomplexität angepasst (z. B. Zeilenhöhe erhöht für Arabisch/CJK).
  • Ikonografie folgt der „Spiegelung vs. Fest“-Logik.
  • Designs verwenden logische Eigenschaften (Start/Ende) anstelle von absoluten (Links/Rechts).
  • Datums-, Währungs- und Zahlenformate sind korrekt lokalisiert.
  • Fallback-Schriftstapel sind für alle Zielschriften definiert.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills