# dart-lang/i18n architecture

> Architecture diagram of the GitHub repository dart-lang/i18n, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dart-lang/i18n
- Repository: https://github.com/dart-lang/i18n

## Overview

This repository is a Dart i18n/l10n package collection. Developers use the formatting and locale APIs for runtime localization, or use message tooling to prepare localized message data for applications. The README documents package responsibilities but not detailed runtime wiring; sampled source covers only a generated Linux Flutter example, so package-to-package edges are limited to explicit documentation.

Main entry points: [`pkgs/messages_builder/lib`](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_builder/lib) (Message builder), [`pkgs/messages_serializer/lib`](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_serializer/lib) (Message serializer), [`pkgs/messages_shrinker/lib`](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_shrinker/lib) (Message shrinker), [`pkgs/messages/lib`](https://github.com/dart-lang/i18n/tree/main/pkgs/messages/lib) (Message runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime_intl["Runtime internationalization"]
  node_intl["intl APIs"]
  node_intl4x["intl4x APIs"]
end

subgraph group_message_runtime["Message localization"]
  node_messages["Message runtime"]
end

subgraph group_message_tools["Message tooling"]
  node_translation["Translation tools"]
  node_builder["Message builder"]
  node_serializer["Message serializer"]
  node_shrinker["Message shrinker"]
end

node_developer(("Dart developer"))
node_message_data["Message data files"]

node_developer -->|"formats and parses"| node_intl
node_developer -->|"uses modular i18n"| node_intl4x
node_developer -->|"translates messages"| node_translation
node_developer -->|"builds messages"| node_builder
node_developer -->|"serializes messages"| node_serializer
node_developer -->|"removes unused"| node_shrinker
node_builder -->|"builds for"| node_messages
node_serializer -->|"serializes for"| node_messages
node_shrinker -->|"removes unused messages"| node_message_data

click node_intl "https://github.com/dart-lang/i18n/tree/main/pkgs/intl/lib"
click node_intl4x "https://github.com/dart-lang/i18n/tree/main/pkgs/intl4x/lib"
click node_translation "https://github.com/dart-lang/i18n/tree/main/pkgs/intl_translation/lib"
click node_messages "https://github.com/dart-lang/i18n/tree/main/pkgs/messages/lib"
click node_builder "https://github.com/dart-lang/i18n/tree/main/pkgs/messages_builder/lib"
click node_serializer "https://github.com/dart-lang/i18n/tree/main/pkgs/messages_serializer/lib"
click node_shrinker "https://github.com/dart-lang/i18n/tree/main/pkgs/messages_shrinker/lib"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_intl,node_intl4x toneBlue
class node_messages toneAmber
class node_translation,node_builder,node_serializer,node_shrinker toneMint
class node_developer,node_message_data toneIndigo
```

## Components

### Runtime internationalization

- [intl APIs](https://github.com/dart-lang/i18n/tree/main/pkgs/intl/lib): `pkgs/intl/lib`
- [intl4x APIs](https://github.com/dart-lang/i18n/tree/main/pkgs/intl4x/lib): `pkgs/intl4x/lib`

### Message localization

- [Message runtime](https://github.com/dart-lang/i18n/tree/main/pkgs/messages/lib): `pkgs/messages/lib`

### Message tooling

- [Translation tools](https://github.com/dart-lang/i18n/tree/main/pkgs/intl_translation/lib): `pkgs/intl_translation/lib`
- [Message builder](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_builder/lib): `pkgs/messages_builder/lib`
- [Message serializer](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_serializer/lib): `pkgs/messages_serializer/lib`
- [Message shrinker](https://github.com/dart-lang/i18n/tree/main/pkgs/messages_shrinker/lib): `pkgs/messages_shrinker/lib`

### Other components

- **Dart developer**
- **Message data files**

## Connections

- Dart developer → intl APIs: formats and parses (evidence: `README.md`)
- Dart developer → intl4x APIs: uses modular i18n (evidence: `README.md`)
- Dart developer → Translation tools: translates messages (evidence: `README.md`)
- Dart developer → Message builder: builds messages (evidence: `README.md`)
- Dart developer → Message serializer: serializes messages (evidence: `README.md`)
- Dart developer → Message shrinker: removes unused (evidence: `README.md`)
- Message builder → Message runtime: builds for (evidence: `README.md`)
- Message serializer → Message runtime: serializes for (evidence: `README.md`)
- Message shrinker → Message data files: removes unused messages (evidence: `README.md`)
