Languages

The app ships with 10 pre-translated languages. On this page you decide which of them your version of the app offers to players, and which one is used by default for a fresh install.

The 10 built-in languages

• English (en)
• Français — French (fr)
• Español — Spanish (es)
• 中文 — Chinese (zh)
• العربية — Arabic (ar) — with full right-to-left layout support.
• Deutsch — German (de)
• Português — Portuguese (pt)
• Русский — Russian (ru)
• 日本語 — Japanese (ja)
• हिन्दी — Hindi (hi)

All 10 are already translated in the source, so you don't need to translate anything to use them.

Step 1 — Open the Languages page

Open the Setup Page in your browser and go to the Languages section in the sidebar. You'll see a list with one row per language, each showing:

• A flag icon and the language's name.
• A Set default button.
• An on/off toggle to enable or disable that language.

Step 2 — Enable the languages you want

Toggle on every language you want to offer to your players. Toggle off the ones you don't want to ship. You can enable as many or as few as you like.

A player will see the languages you enabled in the app's settings screen and can switch between them at any time.

You must keep at least one language enabled — the Setup Page won't let you save if all are turned off.

Step 3 — Pick the default language

The default is the language a brand new player sees on their first launch (before they change it in settings).

Click Set default next to the language you want to use as the default. It'll get a Default badge next to its name.

If you're not sure what to pick, English is a safe default — it's understood by the widest audience.

Step 4 — Save

Click Save at the top of the page. Your choices are written to the project.

Step 5 — Run sync

As with every other setup step, run the sync command in your terminal:

make sync

Adding a new language that isn't in the list (advanced)

The 10 languages above are the ones the app comes translated in. Adding an 11th language (say, Italian or Turkish) is a code-level task — not something the Setup Page can do for you. It involves:

1. Copying the existing English translation file and translating every entry.
2. Adding the new language code to the app's supported list.
3. Regenerating the Dart language bindings.

If you need this, contact us at contact@visuella-dz.com and we can help walk you through it.

Common problems

• "Save button is disabled" — you've turned off every language. Enable at least one.

• "Arabic text is misaligned" — the app auto-flips the layout to right-to-left when Arabic is selected. If something looks off, restart the app once — Flutter re-reads the direction on first launch after a locale change.
• "App still opens in the old language after changing default" — the default only applies to new installs. If you already installed the app on your device, uninstall and reinstall to see the new default kick in.