--- createdAt: 2026-09-09 updatedAt: 2026-09-27 priority: 9 title: "Remix 3 i18n - Complete guide to translate your app" description: "Set up Intlayer in Remix 3: locale detection in router middleware, translated route handlers and views, and localized URLs." keywords: - Internationalization - Documentation - Intlayer - Remix 3 - Remix - JavaScript - TypeScript - Web Standards slugs: - doc - environment - remix-3 applicationTemplate: https://github.com/aymericzip/intlayer-remix-3-template applicationShowcase: https://intlayer-remix-3-template.vercel.app history: - version: 9.5.5 date: 2026-09-19 changes: "Use the remix-intlayer middleware and hooks" - version: 9.5.0 date: 2026-09-09 changes: "Initial documentation for Remix 3" author: aymericzip --- # Translate your Remix 3 website using Intlayer This guide demonstrates how to integrate **Intlayer** for seamless internationalization in **Remix 3** applications with locale-aware routing, type-safe content declarations, server-rendered JSX components, and cross-runtime support across Node.js, Bun, Deno, and Cloudflare Workers. ## What is Remix 3? **Remix 3** represents a fundamental architectural shift towards a **composable, runtime-agnostic web framework built entirely on web standards**. Rather than being coupled to specific bundlers or proprietary server APIs, Remix 3 is distributed as single-purpose, composable packages: - **`remix/fetch-router`** (or `remix/router`): Lightweight, standard-compliant routing built on the Fetch API (`Request` and `Response`). - **`remix/component`**: A JSX component model (`jsxImportSource: "remix/component"`). A component is a setup function that returns a render function, so it looks like React but keeps state in plain JavaScript closures. - **`remix/middleware/render`**: Installs `context.render()` on every request, streaming the JSX tree to an HTML `Response`. - **`remix/node-fetch-server`**: Server adapters for Node.js, while natively supporting Bun, Deno, and edge runtimes. - **`remix/cookie`**: Cryptographically secure cookie parsing and serialization. Combined with **Intlayer** and the **`remix-intlayer`** package, a locale middleware plus the same `useIntlayer` / `useDictionary` / `useLocale` hooks as `react-intlayer`, bound to the Remix request context, you get a complete internationalization system that delivers compile-time safety, automated AI translations, zero-overhead server rendering, and seamless locale routing. ## Table of Contents ## Why Intlayer over alternatives? Compared to traditional solutions like `i18next` or bespoke translation loaders, Intlayer offers an integrated developer experience optimized for modern web architecture: Intlayer is built to work seamlessly with web standards (`Request`, `Response`, `Headers`, and `URL`). `remix-intlayer` plugs into Remix 3's Fetch router as a lightweight middleware, extracting the locale from URL paths, cookies, or `Accept-Language` headers and exposing it to the rest of the request (handlers, views and `remix/component` components) without passing it around or locking you into a specific runtime. Say goodbye to loose JSON keys and runtime missing-key crashes. Intlayer enforces TypeScript checks across all declared locales, warning you at build time if a translation is missing or invalid. Remix 3 renders JSX components on the server and streams the HTML to the client. Only the resolved text for the requested locale ends up in the output stream. No client hydration bundles or bulky translation catalogs are needed unless a component is explicitly marked as a `clientEntry`. Intlayer co-locates content declarations (`.content.ts`) with your route logic, reducing the token context required by Large Language Models (LLMs). Built-in CLI commands like `intlayer fill` and `intlayer test` let you automate translations in CI/CD pipelines at the cost of your own AI provider. Beyond code-first workflows, Intlayer provides a self-hosted [Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) and a [Remote CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) allowing non-technical editors, translators, and copywriters to update content without redeploying code. - [Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) - [Remote CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md) ## Step-by-Step Guide