ReactiveUI.Testing 24.0.0-beta.1

<br> <a href="https://github.com/reactiveui/reactiveui"> <img width="160" heigth="160" src="https://raw.githubusercontent.com/reactiveui/styleguide/master/logo/main.png"> </a> <br>

What is ReactiveUI?

ReactiveUI is a composable, cross-platform model-view-viewmodel framework for all .NET platforms that is inspired by functional reactive programming, which is a paradigm that allows you to abstract mutable state away from your user interfaces and express the idea around a feature in one readable place and improve the testability of your application.

🔨 Get Started 🛍 Install Packages 🎞 Watch Videos 🎓 View Samples 🎤 Discuss ReactiveUI

Documentation

• RxSchedulers - Using ReactiveUI schedulers without RequiresUnreferencedCode attributes

Book

There has been an excellent book written by our Alumni maintainer Kent Boogart.

NuGet Packages

Install the following packages to start building your own ReactiveUI app. <b>Note:</b> some of the platform-specific packages are required. This means your app won't perform as expected until you install the packages properly. See the <a href="https://reactiveui.net/docs/getting-started/installation/">Installation</a> docs page for more info.

Platform	ReactiveUI Package	NuGet
.NET Standard	ReactiveUI
Any	ReactiveUI.SourceGenerators
Unit Testing	ReactiveUI.Testing
WPF	ReactiveUI.WPF
WinUI	ReactiveUI.WinUI
MAUI	ReactiveUI.Maui
Windows Forms	ReactiveUI.WinForms
AndroidX	ReactiveUI.AndroidX
Blazor	ReactiveUI.Blazor
Platform Uno	ReactiveUI.Uno
Platform Uno	ReactiveUI.Uno.WinUI
Avalonia	ReactiveUI.Avalonia
Any	ReactiveUI.Validation
Any	ReactiveUI.Extensions

Choosing a distribution: ReactiveUI.Primitives or System.Reactive

ReactiveUI ships in two interchangeable distributions with an identical public API, both built on the same ReactiveUI.Primitives engine and the same high-performance custom schedulers/sinks. The only difference is which reactive interop types appear in the public API — so you pick a distribution, you don't rewrite code:

The .Reactive family is not "old ReactiveUI" — it runs on the exact same Primitives engine and custom schedulers as the default and simply surfaces System.Reactive.Unit/IScheduler (and Subject<T>) so it composes with code that already uses System.Reactive.

The default distribution drops the System.Reactive dependency for a smaller closure and a better trimming/AOT story, and is markedly faster on the hottest MVVM paths — in representative micro-benchmarks roughly 3–4× faster on WhenAnyValue/ToProperty subscribe and emit, with 5–13× less allocation (for example WhenAnyValue emit drops from ~6.8 MB to ~0.5 MB per run, and ToProperty construction from ~7.3 µs to ~1.0 µs). The fast schedulers now live in ReactiveUI.Primitives and back both distributions.

If you take the default packages, note the public reactive types change: IScheduler → ISequencer, System.Reactive.Unit → RxVoid, and Subject<T>/BehaviorSubject<T> → Signal<T>/BehaviorSignal<T>. To upgrade with zero source changes, reference the matching *.Reactive packages instead — they keep IScheduler, Unit and Subject<T>.

Core routing (RoutingState, IScreen, RoutedViewHost) stays in the main package, but the DynamicData change-set routing/collection/auto-persist helpers now live in a separate ReactiveUI.Routing package (ReactiveUI.Routing.Reactive for the System.Reactive flavor), so core no longer depends on DynamicData. Add ReactiveUI.Routing if you use those extensions.

Analyzers are opt-in

The ReactiveUI packages reference ReactiveUI.Primitives with ExcludeAssets="analyzers", so the analyzers that ship inside ReactiveUI.Primitives do not flow to your project and will not run against your code just because you installed ReactiveUI. We don't impose our analyzers on downstream consumers. If you want them, opt in explicitly by adding a direct reference to ReactiveUI.Primitives (without excluding the analyzer assets), e.g.:

<PackageReference Include="ReactiveUI.Primitives" Version="x.y.z" />

Sponsorship

The core team members, ReactiveUI contributors and contributors in the ecosystem do this open-source work in their free time. If you use ReactiveUI, a serious task, and you'd like us to invest more time on it, please donate. This project increases your income/productivity too. It makes development and applications faster and it reduces the required bandwidth.

Become a sponsor.

Migration from Xamarin and .NET 8 MAUI

Xamarin Users

As of May 2024, Microsoft ended support for Xamarin per their support policy. ReactiveUI has removed support for legacy Xamarin platforms in favor of modern .NET MAUI. For Xamarin projects:

• Xamarin.Forms → Migrate to MAUI and use ReactiveUI.Maui
• Xamarin.Android → Migrate to MAUI Android or use ReactiveUI.AndroidX for native Android
• Xamarin.iOS/Mac → Migrate to MAUI iOS/Mac Catalyst

For guidance on migrating from Xamarin to MAUI, see the official migration documentation.

MAUI Users

ReactiveUI supports .NET 9 and .NET 10 for MAUI platforms:

• net10.0-android / net9.0-android
• net10.0-ios / net9.0-ios
• net10.0-maccatalyst / net9.0-maccatalyst
• net10.0-windows10.0.19041.0 / net9.0-windows10.0.19041.0

Non-MAUI net8.0 library targets remain fully supported.

Examples

Platform-specific sample applications are included in src/examples/:

All samples target .NET 10, use RxAppBuilder for initialization, and demonstrate WhenActivated, Bind/ BindCommand, and proper subscription disposal.

This is how we use the donations:

• Allow the core team to work on ReactiveUI
• Thank contributors if they invested a large amount of time in contributing
• Support projects in the ecosystem

Support

If you have a question, please see if any discussions in our GitHub issues or Stack Overflow have already answered it.

If you want to discuss something or just need help, here is our Slack room, where there are always individuals looking to help out!

Please do not open GitHub issues for support requests.

Contribute

ReactiveUI is developed under an OSI-approved open source license, making it freely usable and distributable, even for commercial use.

If you want to submit pull requests please first open a GitHub issue to discuss. We are first time PR contributors friendly.

See Contribution Guidelines for further information how to contribute changes.

Core Team

<table> <tbody> <tr> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/glennawatson.png?s=150"> <br> <a href="https://github.com/glennawatson">Glenn Watson</a> <p>Melbourne, Australia</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/chrispulman.png?s=150"> <br> <a href="https://github.com/chrispulman">Chris Pulman</a> <p>United Kingdom</p> </td> </tr> <tr> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/rlittlesii.png?s=150"> <br> <a href="https://github.com/rlittlesii">Rodney Littles II</a> <p>Texas, USA</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/cabauman.png?s=150"> <br> <a href="https://github.com/cabauman">Colt Bauman</a> <p>South Korea</p> </td> </tr> </tbody> </table>

Alumni Core Team

The following have been core team members in the past.

<table> <tbody> <tr> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/ghuntley.png?s=150"> <br> <a href="https://github.com/ghuntley">Geoffrey Huntley</a> <p>Sydney, Australia</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/kentcb.png?s=150"> <br> <a href="https://github.com/kentcb">Kent Boogaart</a> <p>Brisbane, Australia</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/olevett.png?s=150"> <br> <a href="https://github.com/olevett">Olly Levett</a> <p>London, United Kingdom</p> </td> </tr> <tr> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/anaisbetts.png?s=150"> <br> <a href="https://github.com/anaisbetts">Anaïs Betts</a> <p>San Francisco, USA</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/shiftkey.png?s=150"> <br> <a href="https://github.com/shiftkey">Brendan Forster</a> <p>Melbourne, Australia</p> </td> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/clairernovotny.png?s=150"> <br> <a href="https://github.com/clairernovotny">Claire Novotny</a> <p>New York, USA</p> </td> </tr> <tr> <td align="center" valign="top" width="105"> <img width="100" height="100" src="https://github.com/worldbeater.png?s=150"> <br> <a href="https://github.com/worldbeater">Artyom Gorchakov</a> <p>Moscow, Russia</p> </td> </tr> </tbody> </table>

.NET Foundation

ReactiveUI is part of the .NET Foundation. Other projects that are associated with the foundation include the Microsoft .NET Compiler Platform ("Roslyn") as well as the Microsoft ASP.NET family of projects, and Microsoft .NET Core.