xamantra / listify Goto Github PK

A flutter todo/task listing example app with advanced state management using Momentum library. Simple on the outside but powerful in the inside. This app has a very simple look and feel. Just todo app but the state management with momentum makes it very powerful. This turned out as a convenient app because of persistent state + persistent navigation (continue where you left off).

• Persistent State - all state is persisted on the device. If you terminate the app and open it again, the states are retained including user inputs.
• Persistent Navigation - navigation between pages is persisted using momentum's powerful built-in router service. If you terminate the app and open it again, the page where you left off will be shown, and pressing the system back button navigates you to the correct previous page means navigation history is also persisted.
• Equatable - skip rebuilds if nothing actually changes. Theming is also optimized with the help of equatable.
• Undo/Redo - undo/redo all inputs.
• Create Copy - create a copy of a list.
• Edit/Delete - in view mode, you can edit or delete a list.
• Reorderable lists - both lists and input items can be reordered.
• Search - simple search feature on the home page.
• App settings - app options that are easily saved using momentum's persistent feature.
• Draft inputs - when the back button is pressed the inputs will be saved as a draft.

• CurrentListController<CurrentListModel> - this is where the current list state is being stored. This is used in the View List page.
• ListController<ListModel> - this is where the list data is validated for duplicates during adding of list, search list, Home page will display all list created, etc.
• InputController<InputModel> - used in Add New List page and the Edit Existing List. The inputs are handled and validated in this component. Undo/Redo feature is also handled here.
• SettingsController<SettingsModel> - used in Settings page and also in some other pages to auto-apply settings.
• ThemeController<ThemeModel> - this is where custom manual theming is handled. Because I'm not too familiar with flutter's theme object structure and props name I decided to do it manually. This is used on every page. This is only injected in the root MyApp() to automatically apply the theme instead of restarting the app.

In this image the process was like this:

• Open the app (Home Page).
• Go to Add New List page.
• Input some data.
• Close and Terminate on task view.
• Reopen the app again.

And magic happens! All the inputs were retained and not just that but also including the page where you left off. Navigation history is also persisted which means pressing the system back button will navigate you to the correct previous page.