Vite Plugin

@lingui/vite-plugin is a Vite plugin, which compiles Lingui catalogs on the fly and provides additional required configuration for Vite.

note

Refer to Setup with Vite for a full installation guide.

Installation

Install @lingui/vite-plugin as a development dependency:

npm

npm install --save-dev @lingui/vite-plugin

Yarn

yarn add --dev @lingui/vite-plugin

pnpm

pnpm add --save-dev @lingui/vite-plugin

Usage

Simply add @lingui/vite-plugin inside your vite.config.ts:

vite.config.ts

import { UserConfig } from "vite";
import { lingui } from "@lingui/vite-plugin";

const config: UserConfig = {
  plugins: [lingui()],
};

Then in your code all you need is to use dynamic imports to load only necessary catalog. Extension is mandatory.

export async function dynamicActivate(locale: string) {
  const { messages } = await import(`./locales/${locale}.po`);

  i18n.load(locale, messages);
  i18n.activate(locale);
}

note

If you are using a format that has a different extension than *.po, you need to specify the ?lingui suffix:

const { messages } = await import(`./locales/${language}.json?lingui`);

See the guide about dynamic loading catalogs for more info.

See Vite's official documentation for more info about Vite dynamic imports.

note

You also need to set up babel-plugin-macros to support macros.