MvvmCross DREAMS is an opinionated take on how to make an MvvmCross app. You can clone DREAMS, rename the application label and bundle identifier and be productive in minutes. No more worrying about naming conventions, PCL profiles, android support dependencies or which logging framework to use.
- "Normal" full screen navigation
- Burgermenu navigation
- Network and background tasks
- Logging to console/logcat and logfile
- Threadsafe dialogs
The solution in structured around the Model-View-ViewModel (MVVM) pattern. For those unfamiliar with this pattern it basically boils down to this:
- Model: Data models, database etc.
- View: UI. On android this often includes xml layout files, and on iOS xib files.
- ViewModel: A "synthesized" version of the view, in which all the underlying data which must be presented by the view is made readily available in a way that is easily digestible by the view.
In addition to the 3 main layers, there is a collection of classes we should mention as well:
- Services: In order to keep our ViewModels small, much business logic is made available through services. Ideally, ViewModels should only contain properties that the View can bind to - all heavy lifting and business logic should be handled by a service. In practice, however, there are often exceptions to this rule, and making services for everything business logic related is overkill.
The folder structure aims to have folders separated by their feature rather than their type.
The solution is released with 5 screens:
FirstView: Shows simple text binding between input fields and textviews. Shows navigation and passing of data to other viewmodels
SecondView: Shows async initialization (fetching data from network to show in view). The fetched data response is cached in a Realm.io database.
ThirdView: Shows how to use lists. On android, the example shows how to get the Material Design feeling by collapsing the toolbar (previously known as the actionbar) when the user scrolls the list.
FourthView: Shows how to make a burger menu
FifthView: Shows how to use dialogs in a threadsafe manner
The solution uses NLog to log to the console and to disk (a logfile).
- Stuart Lodge and the community for MvvmCross
- Martijn van Dijk for his contributions to MvvmCross
- Tomasz Cielecki for his MvvmCross plugins and contributions to MvvmCross
- James Montemagno for his MvvmCross plugins
- Realm.io - Brilliant database
- Polly - Brilliant error handling library
- NLog - Brilliant logging library
- Artm.dk