Migrate from Vue I18n to Intlayer

If your Vue application currently uses vue-i18n, you can migrate to Intlayer without rewriting your components or translating hooks. Intlayer provides a compat adapter that perfectly mirrors vue-i18n's API while leveraging Intlayer's powerful features under the hood.

What to do

To get started, simply run the initialization command in your project:

npx intlayer init

During the initialization, Intlayer will set up your configuration file (intlayer.config.ts) and prepare your project for migration. You will just need to add the Intlayer plugin to your Vite configuration to automatically alias the vue-i18n imports.

import { defineConfig } from "vite";import vue from "@vitejs/plugin-vue";import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";export default defineConfig({  plugins: [vue(), vueI18nVitePlugin()],});

What it does under the hood

The vueI18nVitePlugin injects a module alias into your bundler. Any import of vue-i18n in your codebase will be transparently redirected to @intlayer/vue-i18n.

Under the hood, the adapter handles the complex vue-i18n syntax natively:

• Interpolation & Plurals: Resolves {name} and list {0} interpolations. Pipe plurals ("car | cars") are converted into Intlayer enumeration/plural nodes based on positional semantics.
• Formats: Functions like d() and n() wrap Intl under the hood, honoring the datetimeFormats and numberFormats defined in your options.
• Global & Local State: global.locale is mapped to a WritableComputedRef backed by the Intlayer client, so reactivity behaves exactly as expected (e.g. locale.value = 'fr').
• Directives: The v-t directive is registered and functions normally.

Your application continues rendering exactly as before, but the content is powered by your Intlayer dictionaries, giving you type safety, better bundle optimization, and seamless CMS integration.