James
flutter_architecture_samples
TodoMVC for Flutter!
Flutter gives you a lot of flexibility and freedom in how you structure and architect your apps. While this freedom is very valuable, it can also lead to apps with large classes, inconsistent naming schemes, as well as mismatching or missing architectures. These and a variety of other issues might make it difficult to test, maintain, and extend your programs.
Thus, The Flutter Architecture Samples project demonstrates techniques for resolving or avoiding these common issues. This project implements the same app using different architectural concepts and tools.
The samples in this project can be used as a learning resource or as a starting point for developing your own apps. The focus of this project is on demonstrating how to structure your code, design your architecture, and the eventual influence of adopting these patterns on testing and maintaining your app. To build apps, you can use the techniques demonstrated here in a variety of different ways.
However, you should not consider these samples to be canonical examples because how you implement the concepts in these projects will be influenced by your personal priorities. The app uses a basic UI to keep the focus on the above-mentioned goals.
Current Samples
Examples have been updated to Dart 2.
- Lifting State Up (Vanilla) Example – Uses the tools Flutter provides out of the box to manage app state.
- InheritedWidget Example – Uses an InheritedWidget to pass app state down the widget hierarchy.
- Redux Example – Uses the Redux library to manage app state and update Widgets
- built_redux Example – Uses the built_redux library to enforce immutability and manage app state
- scoped_model Example – Uses the scoped_model library to hold app state and notify Widgets of Updates
- Firestore Redux Example – Uses the Redux library to manage app state and update Widgets and adds Cloud_Firestore as the Todos database.
- MVU Example – Uses the dartea library to manage app state and update Widgets.
- ReduRx Example – Uses the redurx + flutter_redurx libraries as a new way to handle state using RxDart and StreamBuilder based on a Redux store.
Supporting Code
- integration_tests – Demonstrates how to write selenium-style integration (aka end to end) tests using the Page Object Model. This test suite is run against all samples.
- todos_repository – Demonstrates the repository pattern and testing strategies for working with the filesystem. Used to provide local storage and mock web storage to samples.
Why a todo app?
The app in this project aims to be simple enough that you can understand it quickly, but complex enough to showcase difficult design decisions and testing scenarios. For more information, you see the app’s specification.
Be excellent to each other
This Repo is meant as a discussion platform for various architectures. Let us debate these ideas vigorously, but let us be excellent to each other in the process!
While healthy debate and contributions are very welcome, trolls are not. Read the code of conductfor detailed information.
GitHub
https://github.com/brianegan/flutter_architecture_samples
