This is a Flutter sample application. It is a simple application that connects to the ZenQuotes server using the REST API.
After cloning the project run:
cd <path_to_this_project>
flutter pub get
flutter run
To use the application you must be logged in. You can get 3 types of response depending on the combination of password and email you enter
- By email:
admin@admin.comand password:Admin123, you will login successfully - By email:
repeated@admin.comand any password, you will get the response:email already in use - By any email and any password, you will get the response:
email/password combination does not match
After successful login you will be able to see the quote of the day in the home screen.
Each call to ZenQuotes to get the today quote receives the same quote until the next day, so there is no need to call the server more than once a day. To avoid this, a cache has been implemented that only calls the server if necessary.
In this project, the hexagonal architecture was implemented and the BLoC pattern was used for state management.
| Package | What it solves |
|---|---|
| flutter_bloc | A collection of Widgets that make it easy to integrate blocs and cubits into Flutter |
| freezed | A code generator for unions/pattern-matching/copy. It helps to reduce boilerplate |
| get_it | A simple service locator. It helps to reduce boilerplate and it is used also to manage the DI |
| injectable | A code generator that can be used in conjunction with get_it |
| dartz | Functional programming in Dart. The Either and Option classes are very useful when you use them with server calls |
| shared_preferences | Wraps platform-specific persistent storage for simple data (NSUserDefaults on iOS and macOS, SharedPreferences on Android, etc.). |
| google_fonts | The google_fonts package for Flutter allows you to easily use any of the thousands of fonts available from fonts.google.com in your Flutter app. |
| local_auth | This Flutter plugin provides means to perform local, on-device authentication of the user. |
This was a weekend project so there are some features that I was unable to add and it has some technical debts. I name some of them below
| ... | Name | Detail |
|---|---|---|
| ❌ | Widget testing | I only carried out the unit tests, I lacked time to carry out more tests on the widgets |
I need to refactor a function to achieve 100% code coverage
After adding widget testing on some screens, this is what full coverage looks like
