Translations

AliasVault supports multiple languages across all applications. Currently supported languages:

  • English
  • Dutch

Adding a New Language

To add a new language to AliasVault, follow these steps in order:

Step 1: Configure Crowdin Integration

  1. Update crowdin.yml: Add the new language identifier to the crowdin.yml file in the root of the repository
  2. Crowdin will automatically:
    • Fetch changes from the main branch
    • Offer new content for translation in the Crowdin web interface
    • Create translation files for the new language

Step 2: Web App (Blazor WASM)

  1. Add language to LanguageService: Update apps/server/AliasVault.Client/Services/LanguageService.cs with the new language identifier
  2. Translation files to create (optional, Crowdin should make a PR for this automatically):
    • apps/server/AliasVault.Client/wwwroot/locales/{language-code}.json
    • apps/server/AliasVault.Client/Resources/{language-code}.resx files

Step 3: Browser Extension

  1. Add language identifier to config: Update /apps/browser-extension/src/utils/i18n/config.ts and insert new language based on existing structure
  2. Create language file (optional, Crowdin should make a PR for this automatically):
    • apps/browser-extension/src/locales/{language-code}.json

Step 4: Mobile App - React Native

  1. Add language identifier to config: Update /apps/mobile-app/i18n/index.ts and insert new language based on existing structure 2 Create translation file (optional, Crowdin should make a PR for this automatically): apps/mobile-app/i18n/locales/{language-code}.json

Step 5: Mobile App - iOS Native

Location: apps/mobile-app/ios/

  1. Add language in Xcode:
    • Open workspace in Xcode
    • Go to “AliasVault” > Project settings “Info” > Localizations
    • Add the desired language
  2. Translation files to create (optional, Crowdin should make a PR for this automatically):
    • AliasVault/{language-code}.lproj/Localizable.strings
    • AliasVault/{language-code}.lproj/InfoPlist.strings
    • Autofill/{language-code}.lproj/Localizable.strings
    • VaultUI/{language-code}.lproj/Localizable.strings

Step 6: Mobile App - Android Native

Location: apps/mobile-app/android/app/src/main/res/

  1. Update locales config: Add the language to xml/locales_config.xml
  2. Create translation file (optional, Crowdin should make a PR for this automatically): values-{language-code}/strings.xml

Translation File Locations Summary

React Native mobile app:

  • apps/mobile-app/i18n/locales/en.json
  • apps/mobile-app/i18n/locales/nl.json

Browser Extension:

  • apps/browser-extension/src/locales/en/**/*.json
  • apps/browser-extension/src/locales/nl/**/*.json

Web App (Blazor WASM):

  • apps/server/AliasVault.Client/wwwroot/locales/en.json
  • apps/server/AliasVault.Client/wwwroot/locales/nl.json
  • apps/server/AliasVault.Client/Resources/**/*.en.resx
  • apps/server/AliasVault.Client/Resources/**/*.nl.resx

Android app native:

  • apps/mobile-app/android/app/src/main/res/values/strings.xml (default, English)
  • apps/mobile-app/android/app/src/main/res/values-nl/strings.xml (Dutch)

iOS app native:

  • apps/mobile-app/ios/AliasVault/en.lproj/Localizable.strings (default, English)
  • apps/mobile-app/ios/AliasVault/nl.lproj/Localizable.strings (Dutch)
  • apps/mobile-app/ios/Autofill/en.lproj/Localizable.strings (default, English)
  • apps/mobile-app/ios/Autofill/nl.lproj/Localizable.strings (Dutch)
  • apps/mobile-app/ios/VaultUI/en.lproj/Localizable.strings (default, English)
  • apps/mobile-app/ios/VaultUI/nl.lproj/Localizable.strings (Dutch)

Crowdin Integration

AliasVault uses Crowdin for translation management with GitHub App integration. The project is configured with a centralized crowdin.yml file in the root of the repository that manages all translation files across the monorepo.

The Crowdin GitHub App automatically:

  • Fetches changes from the main branch as soon as they become available
  • Offers new content for translation in the Crowdin web interface
  • Manages translation file synchronization across all applications

Installing Crowdin CLI on MacOS for manually syncing source files:

brew tap crowdin/crowdin
brew install crowdin@4
brew link --force --overwrite crowdin@4

To test uploading of source files via CLI to detect any issues with formatting:

crowdin upload --token=[api_token] --project-id=808100

Example output which may indicate errors:

✔️  Directory 'apps/mobile-app/ios/Autofill'
✔️  Directory 'apps/mobile-app/ios/Autofill/en.lproj'
❌ File 'apps/mobile-app/ios/Autofill/en.lproj/Localizable.strings'
❌ Wrong parameters:
<key: type, code: callbackValue, message: Unsupported type>
✔️  Directory 'apps/mobile-app/android'
✔️  Directory 'apps/mobile-app/android/app'
✔️  Directory 'apps/mobile-app/android/app/src'
✔️  Directory 'apps/mobile-app/android/app/src/main'
✔️  Directory 'apps/mobile-app/android/app/src/main/res'
✔️  Directory 'apps/mobile-app/android/app/src/main/res/values'
✔️  File 'apps/mobile-app/android/app/src/main/res/values/strings.xml'