Flutter architecture

5 min readOct 21, 2020


Project architecture (Clean Architecture Approach)

1. Why:

* We want to determine what types of database that we use for storage (might want to change it later on)
* We want to adhere to SOLID principles since we are using OOP for this project.
* We want to ensure that UI layers do not care what is going on at the data layer at all.
* We might want to separate each layer into different packages.

2. Presentation — Domain — Data.3. Presentation layer consist of

* Widgets
* BLoC
* Bloc only manages UI state based on business logic

4. Domain layer (Business logic layer)

* Repositories (interfaces aka idea how the logic would behave)
* Entities (or models that UI needs)
* Usecases (user stories)
* Typically one function, but can be more if functions are related.
* Remember, one class has one responsibility only.

5. Data layer (Data access layer)

* source
* remotes (API)
* locals (Database)
* model
* request
* response
* Repositories (Implementation from Domain layer)

We build this class working separately and not following logics of Domain layer. However, Repositories will still implement from Domain layer, but the Domain layer will follow each function, and the Data layer will follow the cluster of data defined on the server. For example: Domain layer has defined 2 layers of Login and Register features, but these two features are related to the API User cluster on the server, so in the Data layer, there will only be one Repo which is user and that Repo will implement 2 layers Login and Register of the Domain layer.

6. More insight of layers

DI pattern

Dependency Injection is a great design pattern that allows us to eliminate rigid dependencies between elements and it makes the application more flexible, easy to expand scales and maintain. In the project we use Plugin get_it to implement DI and we have also defined classes so you can easily implement DI in the DI layer.


Inject modules


* Declare the modules used in the project.
* All modules must extend "DIModule"
* The registers must be set in the func provides.
* When you want to call 1 DI just use the syntax. "getIt<My Component>()"
* Learn more about "get_it"


The project has predefined Named routes RouteDefine + manifest

1. RouteDefine

* All routes must extend this class.
* When extending, you will have to override func "initRoute", here you will define your routes.
* A feature may have multiple routes with different input arguments.
* Make sure that the ID of each route in your project is unique.

2. manifest — lib/config/src/route/manifest.dart

*  To add a route to the project you just need to declare in the func "generateRoute". Each route will be provided with a func "build", you must call it in the func "generateRoute" of "manifest" to register.


* Project can use retrofit to work with the alternative network for http.
* Retrofit is pre-installed in the "ApiModule.dart". You can customize it here
* All interceptors are defined in the lib/config/src/interceptor/* class
* To work with Certificate, please refer to the "lib/config/src/http_overrides.dart" class, with the default the project accept badCertificate

Development environment settings.

* All flavor environments are installed in the "/lib/config/src/buid_config.dart" class.
* Basically we are defining 4 development environments: development, staging, preprod and release.
* Run App

You can run the app using the commands

## development: flutter run -t lib/main.dart --debug --flavor development## staging: flutter run -t lib/main.dart --debug --flavor staging## preprod: flutter run -t lib/main.dart --debug --flavor preprod

Build App

You can build the app using the commands

for Android

## development: flutter build apk -t lib/main.dart --flavor development## staging: flutter build apk -t lib/main.dart --flavor staging## preprod: flutter build apk -t lib/main.dart --flavor preprod

for IOS

## development flutter build ios -t lib/main.dart --flavor development## staging: flutter build ios -t lib/main.dart --flavor staging## preprod: flutter build ios -t lib/main.dart --flavor preprod


* All resources (images, fonts, videos, ...) must be placed in the assets class
* Before using them, please declare the path in utility class and the suffix of the class to be type_provide (image_provide.dart)

Getting started

Get dependencies and generate necessary files.

npm run init

We’ll handle the generation of required files for 🚀 your onboarding!

Json parsing / serialization

This project is implementing json_serializable. It use build_runner to generate files. If you make a change to these files, you need to re-run the generator using build_runner:

flutter pub run build_runner build

generator using build_runner and remove conflict file :

npm run generate


  • Auto indentation handled with git hook using Lefthook.
  • For mac users, run npm run setup and you should be done. More details below.
  • This project use npm for Lefthook installation, to ease others getting it up running fast — run npm install
  • After installation, run npx lefthook install to finish up installation.
  • More info here.


Using this library to handle multi-languages. Follow this guide to understand and config languages files

Setup Step :

flutter pub global activate intl_utilsflutter pub global run intl_utils:generate

Initialize plugins (IntelliJ reference)

  1. Open Flutter intl in Action
  2. Click on arb File
  1. To add / remove Locale, choose Add Locale / Remove Locale
  2. Then it will promp which locale

Current available locale is en, en

Source: https://github.com/VNAPNIC/Flutter_Architecture