# Documentation

## Page index

- Intl: / - Drop-in internationalization primitives for Web Components, built for readable, composable, runtime-safe localized interfaces.
- Why Intl?: /documentation/ - Learn why Intl provides HTML-first localization primitives for Web Components and component-first interfaces.
- Get Started: /documentation/get-started - Build your first multilingual UI with one runtime scope and reusable formatters.
- Installation: /documentation/installation - Install Intl for browser CDN usage or module usage in any framework.
- Guide & Best Practices: /documentation/guide-best-practices - Practical guidance for building maintainable HTML-first localization with Before Semicolon Intl.
- intl-locale: /documentation/components/intl-locale - Define locale runtime boundaries, load messages, update document language, and scope child Intl components.
- intl-msg: /documentation/components/intl-msg - Resolve runtime messages by key with text fallback and placeholder interpolation.
- intl-number: /documentation/components/intl-number - Format numbers, currencies, percentages, units, compact notation, digit ranges, and numbering systems.
- intl-datetime: /documentation/components/intl-datetime - Format Date, timestamp, and date string values with Intl.DateTimeFormat options.
- intl-duration: /documentation/components/intl-duration - Format millisecond durations with selected fields and long, short, narrow, or digital styles.
- intl-rel-time: /documentation/components/intl-relative-time - Render relative timestamps or unit offsets with live updates and accessible labels.
- intl-list: /documentation/components/intl-list - Format localized conjunction, disjunction, and unit lists from child text or a value.
- intl-name: /documentation/components/intl-name - Render localized names for regions, languages, scripts, and currencies.
- intl-plural: /documentation/components/intl-plural - Select cardinal and ordinal plural text from locale-aware Intl.PluralRules categories.
- intlMsg: /documentation/formatters/intl-message - Resolve a message key from an Intl runtime and interpolate placeholder values.
- intlNumber: /documentation/formatters/intl-number - Format decimal, currency, percent, unit, compact, and rounded numbers with Intl.NumberFormat.
- intlDateTime: /documentation/formatters/intl-date-time - Format Date, timestamp, and ISO string values with Intl.DateTimeFormat.
- intlDuration: /documentation/formatters/intl-duration - Format millisecond durations into localized duration strings.
- intlRelTime: /documentation/formatters/intl-relative-time - Format relative timestamps or unit offsets with Intl.RelativeTimeFormat.
- intlList: /documentation/formatters/intl-list - Format localized lists with Intl.ListFormat.
- intlName: /documentation/formatters/intl-name - Display localized language, region, script, and currency names with Intl.DisplayNames.
- intlPlural: /documentation/formatters/intl-plural - Select cardinal or ordinal plural output with Intl.PluralRules.
- createIntl: /documentation/apis/create-intl - Create an isolated Intl runtime for a component region, micro-app, or integration boundary.
- initIntl: /documentation/apis/init-intl - Initialize or replace the default Intl runtime used by helper functions and unscoped components.
- getIntl: /documentation/apis/get-intl - Read the active Intl runtime, either from an explicit scope or from the package default runtime.
- setLocale: /documentation/apis/set-locale - Change the active locale on a runtime and load messages for the new locale.
- loadLocale: /documentation/apis/load-locale - Load messages for the current or requested locale without necessarily changing the active runtime locale.
- subscribeIntl: /documentation/apis/subscribe-intl - Subscribe to Intl runtime snapshots when locale, loading status, or messages change.
- destroyIntl: /documentation/apis/destroy-intl - Destroy the default or scoped Intl runtime and clear subscriptions, caches, and pending loads.
- resetIntl: /documentation/apis/reset-intl - Reset the package default Intl runtime, mainly for tests and controlled runtime teardown.
- getLocaleDirection: /documentation/apis/get-locale-direction - Resolve text direction for a locale using Intl.Locale.
- onLocaleMessagesLoaded: /documentation/apis/on-locale-messages-loaded - Register the intl-locale component and return locale lifecycle behavior for the browser entrypoint.