# TanStack i18n Documentation

Locale routing, persistence, and TanStack Start/Router adapters for i18n.

## Markdown Alternative Formats
Every page in these docs is available in raw, unformatted markdown. Append `.md` to any documentation URL path (e.g. `/get-started.md`) to retrieve the raw text source.

## Documentation Index
- [AI Integration](/ai.md): Integrate TanStack i18n with AI coding assistants. Learn how to access machine-readable plain-text /llms.txt and raw Markdown page formats.
- [Examples](/examples.md): Explore official integration examples for React, Solid, TanStack Start, and TanStack Router. Run and test complete configurations on StackBlitz.
- [Get started](/get-started.md): Get started with TanStack i18n. Install the library, configure your locale runtime, and learn the architectural boundaries for message translations.
- [Adapters](/guides/adapters.md): Configure locale persistence and inference adapters. Learn how to use cookies, server functions, and Accept-Language headers in TanStack i18n.
- [Change locale](/guides/change-locale.md): Implement a reactive language switcher. Learn how to utilize createLocaleProvider and setLocale to update routing and user preference states.
- [Configuration](/guides/configuration.md): Configure TanStack i18n using defineLocaleConfig. Set up locales, URL prefixes, persistence adapters, and first-visit redirection strategies.
- [Locale runtime](/guides/locale-runtime.md): Create and bind your locale runtime using createLocaleRuntime. Access isomorphic locale status, url helpers, and state detection utilities.
- [TanStack Router](/guides/tanstack-router.md): Integrate TanStack i18n with TanStack Router. Set up localized route trees and configure type-safe navigation helpers like createNavigation.
- [TanStack Start](/guides/tanstack-start.md): Configure TanStack Start for i18n routing. Learn how to wrap server entry handlers to support cookies, redirects, and locale detection.
- [URL prefix modes](/guides/url-prefix.md): Manage URL language routing prefixes. Configure always, as-needed, or custom prefix paths, and define ignored routes and URL segments.
- [TanStack i18n](/index.md): Manage locale routing for TanStack Start and TanStack Router. Implement redirects, URL prefixes, and persist adapters with any translation library.
- [Integrations](/integrations.md): Integrate TanStack i18n routing with message and translation libraries. Explore guides for react-intl, use-intl, react-i18next, and Paraglide.
- [Paraglide](/integrations/paraglide.md): Integrate TanStack i18n locale routing with Paraglide JS compile-time translation functions in React and Solid applications.
- [react-i18next (React)](/integrations/react-i18next.md): Integrate react-i18next with TanStack i18n routing. Keep translation catalogs and routing state synchronized in React applications.
- [react-intl (React)](/integrations/react-intl.md): Pair TanStack i18n routing with react-intl. Set up FormatJS message formatting and synchronize the active language context in React.
- [Solid Primitives i18n (Solid)](/integrations/solid-primitives-i18n.md): Combine Solid Primitives i18n with TanStack i18n locale routing. Build reactive, localized user interfaces in SolidJS applications.
- [use-intl (React)](/integrations/use-intl.md): Wire use-intl with TanStack i18n. Configure message catalogs, wrap routes in IntlProvider, and set up locale state syncing via beforeLoad.
- [Migration](/migration.md): Migrate your existing locale routing architecture to TanStack i18n. Transition from Next.js next-intl or Remix remix-i18next smoothly.
- [next-intl](/migration/next-intl.md): Migrate from Next.js App Router and next-intl to TanStack i18n. Transition URL routing, redirects, and state persistence rules.
- [remix-i18next](/migration/remix-i18next.md): Migrate from Remix and remix-i18next to TanStack i18n. Shift route path matching and locale persistence to TanStack Router.
- [Behavior contract](/reference/behavior.md): Understand the TanStack i18n execution contract. Study server-entry resolution, redirection behavior, and adapter fallback orders.
- [Exports and peers](/reference/exports.md): Verify TanStack i18n package entry points and subpath exports. Inspect required and optional peer dependencies for React and Solid.