API Reference - Webpack Loader (@lingui/loader)

It’s a good practice to use compiled message catalogs during development. However, running compile everytime messages are changed soon becomes tedious.

@lingui/loader is a webpack loader, which compiles messages on the fly:


Install @lingui/loader as a development dependency:

npm install --save-dev @lingui/loader
# yarn add --dev @lingui/loader


Simply prepend @lingui/loader: in front of path to message catalog you want to import. Here’s an example of dynamic import:

class I18nLoader extends React.Component {
   loadMessages = (language) => {
      return await import(`@lingui/loader!./locale/${language}/messages.json`)

   render() {
      // ...

See the guide about dynamic loading catalogs for more info.