Slang as Localization

Today, it has become a must for widely-used applications to have some basic features like dark mode, different localizations and many more. That is why, most experienced engineers always start the application with architecting these basic features, leaving room for further implementation. There are many choices out there to implement localization in Flutter application. In this article, let's talk about the way I like to implement one using Slang.

Firstly, let's create a sample project:

flutter create slang_project

Now, let's create packages directory to hold private packages of the app and create app_localization package in it.

 cd packages && flutter create --template=package app_localization

It is time to add slang packages in pubspec.yaml.

name: app_localization
description: This package contains app localization.

environment:
  sdk: ">=3.0.0 <4.0.0"

dependencies:
  slang: ^4.4.0
  slang_flutter: ^4.4.0

dev_dependencies:
  build_runner: ^2.4.14
  slang_build_runner: ^4.4.0

Now, let's add the build_runner configuration for the slang in build.yaml file. For more custom configuration, please refer here.

targets:
  $default:
    builders:
      slang_build_runner:
        options:
          base_locale: en
          fallback_strategy: base_locale
          input_directory: lib
          input_file_pattern: .i18n.json
          output_directory: lib
          output_file_pattern: .g.dart
          translate_var: tr

We can add create json files for translations in lib directory and populate them.

{
  "welcomeMessage": "Welcome to the application!",
  "changeLocale": "Change locale here"
}

{
  "welcomeMessage": "Добро пожаловать в приложение!",
  "changeLocale": "Измените локализацию здесь"
}

Now, go to app_localization directory and run slang build runner as below and it will generate necessary classes to use in the app.

cd app_localization && dart run slang

It is time to import the private app_localization package into our main app, for this in main app's pubspec.yaml file import as below and run flutter pub get:

...
dependencies:
  flutter:
    sdk: flutter
  flutter_localizations: // add this
    sdk: flutter

  cupertino_icons: ^1.0.8
  
  app_localization:  // add this
    path: packages/app_localization
...