Localize your Flutter app to multiple locales within seconds

Why Flutter Locales

✅ Easily Localize your app
✅ Change App Locale within the app
✅ Get Last Changed locale on App starts
✅ Save Locale Language After changed buy LocaleNotifier
✅ Get Translation with LocaleText('key') Widget

Example App

Look at a Simple app at GitHub.

Example App

1) Create locales assets

Create an assets/locales folder at the root of your project and add your locales json files. like: Example app assets/locales

  • your locale files name shall be name of the language
    • like:
      • en.json For english locales
      • ps.json for pashto locales

2) Include package and assets

Include latest dependency of flutter_locales

    sdk: flutter

Include assets/locales/ folder

  uses-material-design: true
    - assets/locales/

3) Initialize app

Replace your main app with

void main() async {
  await Locales.init(['en', 'fa', 'ps']); // get last saved language
  // remove await if you want to get app default language

  • ['en', 'fa', 'ps'] are language codes of .json files located in located in assets/locales folder

Wrap your MaterialApp with LocaleBuilder

class MyApp extends StatelessWidget {
  Widget build(BuildContext context) {
    return LocaleBuilder(
      builder: (locale) => MaterialApp(
        title: 'Flutter Locales',
        localizationsDelegates: Locales.delegates,
        supportedLocales: Locales.supportedLocales,
        locale: locale,
        theme: ThemeData(primarySwatch: Colors.blue),
        home: HomeScreen(),
  • LocaleBuilder rebuild the app you change the app locale by LocaleNotifier.of(context).change('ps')

Change App Locale

LocaleNotifier Use To change app locale

  • When you change app automatically saves at Locale
  • To get current locale call LocaleNotifier.of(context).locale

Locale Text

LocaleText Widget Use to translate a key

  • LocaleText Translate a key to string
  • To get a key translated call Locales.string(context, 'welcome')

Getting Started

This project is a starting point for a Dart package, a library module containing code that can be shared easily across multiple Flutter or Dart projects.

For help getting started with Flutter, view our online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.