MvvmCross/MvvmCross


The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Windows and Mac.

http://mvvmcross.com

License: MS-PL

Language: C#

Keywords: android, c-sharp, dotnet, ios, macos, mono, monodroid, monotouch, mvvm, mvvmcross, mvx, nuget, tvos, uwp, visual-studio, wpf, xamarin, xamarin-forms


MvvmCross Logo

MvvmCross

Twitter: @MvvmCross license Build status NuGet NuGet Pre Release MyGet OpenCollective OpenCollective CodeFactor

👀 Check out mvvmcross.com to get started with MvvmCross 👀

MvvmCross is a cross-platform MVVM framework. It enables developers to create apps using the MVVM pattern on Xamarin.iOS, Xamarin.Android, Xamarin.Mac, Xamarin.Forms, Universal Windows Platform (UWP) and Windows Presentation Framework (WPF). This allows for better code sharing by allowing you to share behavior and business logic between platforms.

Among the features MvvmCross provides are:

  • ViewModel to View bindings using own customizable binding engine, which allows you to create own binding definitions for own custom views
  • ViewModel to ViewModel navigation, helps you share behavior on how and when to navigate
  • Inversion of Control through Dependency Injection and Property Injection
  • Plugin framework, which lets you plug-in cool stuff like GPS Location, Localization, Sensors, Binding Extensions and a huge selection of 3rd party community plug-ins

MvvmCross is extendable by you. We strive to let as much code be configurable and overridable, to let the developer decide how they want to use the framework. However, the framework is very usable without doing anything.


Check out the MvvmCross docs


Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Installation

Grab the latest MvvmCross NuGet package and install in your solution.

Install-Package MvvmCross

Make sure that both the shared core project and your application projects include the NuGet. For more details please visit the Getting Started documentation. which also provide easier ways, through Visual Studio and Xamarin Studio plugins to install and manage MvvmCross in your project.

Filing issues

We strive to keep the GitHub issues list for bugs, features and other important project management tasks. If you have questions please see the Questions & support section below.

When filing issues, please select the appropriate issue template. The best way to get your bug fixed is to be as detailed as you can be about the problem. Providing a minimal git repository with a project showing how to reproduce the problem is ideal. Here are a couple of questions you can answer before filing a bug.

  1. Did you try find your answer in the documentation
  2. Did you include a snippet of the broken code in the issue?
  3. Can you reproduce the problem in a brand new project?
  4. What are the EXACT steps to reproduce this problem?
  5. What platform(s) are you experiencing the problem on?

Remember GitHub issues support markdown. When filing bugs please make sure you check the formatting of the issue before clicking submit.

Contributing code

We are happy to receive Pull Requests adding new features and solving bugs. As for new features, please contact us before doing major work. To ensure you are not working on something that will be rejected due to not fitting into the roadmap or ideal of the framework.

Git setup

Since Windows and UNIX-based systems differ in terms of line endings, it is a very good idea to configure git autocrlf settings.

On Windows we recommend setting core.autocrlf to true.

git config --global core.autocrlf true

On Mac we recommend setting core.autocrlf to input.

git config --global core.autocrlf input

Code style guidelines

Please use 4 spaces for indentation.

Otherwise default ReSharper C# code style applies.

Project Workflow

Our workflow is loosely based on Github Flow. We actively do development on the develop branch. This means that all pull requests by contributors need to be develop and requested against the develop branch. The master branch contains tags reflecting what is currently on NuGet.org.

Submitting Pull Requests

Make sure you can build the code. Familiarize yourself with the project workflow and our coding conventions. If you don't know what a pull request is read this https://help.github.com/articles/using-pull-requests.

Before submitting a feature or substantial code contribution please discuss it with the team and ensure it follows the MvvmCross roadmap. Note that code submissions will be reviewed and tested. Only code that meets quality and design/roadmap appropriateness will be merged into the source. Don't "Push" Your Pull Requests

Questions & support

Licensing

MvvmCross is licensed under the MS-PL License

  • MonoCross was the original starting point for this project, and was used as a reference under MIT
  • Tiny bits of MvvmLight are redistributed and modified under MIT
  • Messenger ideas from JonathanPeppers/XPlatUtils under Apache License Version 2.0, and from GrumpyDev/TinyMessenger under simple license of "THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY"
  • Color codes under MIT License
  • Some bits of Mvvm.Async are redistributed and modified under MIT License

Acknowledgements

  • Thanks to McCannLondon for sponsoring the initial part of this work
  • Thanks to JetBrains for a community Resharper license to use on this project

.NET Foundation

This project is supported by the .NET Foundation.

Project Statistics

Sourcerank 18
Repository Size 69.2 MB
Stars 2,976
Forks 1,152
Watchers 292
Open issues 174
Dependencies 356
Contributors 316
Tags 346
Created
Last updated
Last pushed

Top Contributors See all

Martijn van Dijk hollywoof Stuart Lodge Tomasz Cielecki nmilcoff Nick Randolph Nick Randolph Marc Bruins Jeremy Kolb Kerry W. Lothrop Jonathan Froon Tim Uy Maurits van Beusekom William Barbosa Chris van de Steeg Przemysław Raciborski Garfield Lee guillaume-fr Nick Randolph Nick Randolph

Packages Referencing this Repo

MvvmCross
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.All
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.Location.Fused
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.V17.Leanback
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.Accelerometer
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.Core.Utils
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.V14.Preference
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.Fragment
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.V7.Preference
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.V7.RecyclerView
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.Email
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.CodeAnalysis
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Forms
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.V7.AppCompat
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.Design
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.JsonLocalization
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.ResourceLoader
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Plugin.Color
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Droid.Support.Core.UI
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars
MvvmCross.Platforms.Wpf
MvvmCross is the .NET MVVM framework for cross-platform solutions, including Xamarin iOS, Xamarin...
Latest release 6.4.0 - Updated - 2.98K stars

Recent Tags See all

6.4.0 September 09, 2019
6.4.0 September 09, 2019
6.3.1 June 18, 2019
6.3.0 May 15, 2019
6.2.3 February 13, 2019
6.2.2 November 07, 2018
6.2.1 October 10, 2018
6.2.0 September 13, 2018
6.2.0-beta4 September 13, 2018
6.2.0-beta3 August 17, 2018
6.2.0-beta2 July 12, 2018
6.2.0-beta1 July 10, 2018
6.1.2 June 18, 2018
6.1.1 June 12, 2018
6.1.0 June 11, 2018

Interesting Forks See all

Mvvmcross-Cn/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Win...
This repository is no longer available - 2 stars
lothrop/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Win...
C# - MS-PL - Last pushed - 2 stars
mystudylife/MvvmCross
The Mvvm Platform for Xamarin.iOS, Xamarin.Android, WindowsPhone, WindowsStore, WPF and Mac. Incl...
C# - MS-PL - Last pushed - 1 stars
martijn00/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Win...
C# - MS-PL - Last pushed - 1 stars
Xablu/MvvmCross
The .NET MVVM framework for cross-platform solutions, including Xamarin.iOS, Xamarin.Android, Win...
C# - MS-PL - Last pushed - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-09-09 14:36:33 UTC

Login to resync this repository