Internationalization

Previous

Add theme translations

The theme supports the lang attribute. This page aims to describe how to add additional translations.

First setup the project.

Create a specific directory for your lang (see ISO639 for the full list).

mkdir -p shadcn/locales/<lang>/LC_MESSAGES

Generates a messages.po in that directory (it may also update other langs if new tokens have been added):

uv run ./manage.py makemessages

The manage.py script is a dev CLI tool with several commands that ease developer tasks.

Edit translations in shadcn/locales/<lang>/LC_MESSAGES/messages.po (the file previously generated). You can look at the fr example.

Compile the translations (it generates messages.mo) with

uv run ./manage.py compilemessages
Setup