Compile-time code for ReactiveUI. No reflection. Trim and NativeAOT safe.
Two families of Roslyn source generators that work together:
| Attribute generators | Binding generators | |
|---|---|---|
| Package | ReactiveUI.SourceGenerators |
ReactiveUI.Binding (and platform packages) |
| You write | [Reactive], [ReactiveCommand], [IViewFor] |
WhenChanged, Bind, ToProperty, [ObservableAsProperty] |
| You get | Properties, commands, views, collections | Observations and bindings, with no expression trees |
| Guide | Attribute generators | Binding reference |
Attributes. Mark a field. The property, its change notification and the command are written for you.
public partial class LoginViewModel : ReactiveObject { [Reactive] private string _userName = ""; [ReactiveCommand] private void SignIn() { } }
Binding. Name the path as a lambda. The generator writes the code that attaches to each link of it.
IObservable<string> city = viewModel.WhenChanged(x => x.Address.City); view.OneWayBind(viewModel, x => x.UserName, v => v.NameLabel.Text);
dotnet add package ReactiveUI.SourceGenerators # attribute generators dotnet add package ReactiveUI.Binding # binding generators, no System.Reactive dotnet add package ReactiveUI.Binding.Reactive # binding generators on System.Reactive
Reference one binding runtime package, not both. Add PrivateAssets="all" to ReactiveUI.SourceGenerators.
| Package | Purpose |
|---|---|
ReactiveUI.SourceGenerators |
Attribute generators |
ReactiveUI.Binding, ReactiveUI.Binding.Reactive |
Binding runtime, generator and analyzer |
ReactiveUI.Binding.Wpf, .WinForms, .Maui, .Avalonia, .Uno |
Platform property observation and view thread routing |
*.Reactive platform packages |
The same, for System.Reactive apps |
| Attribute generators | Binding generators | |
|---|---|---|
| Language | C# 12 | C# 7.3 for generated code; interceptors need C# 11 |
| Compiler | Roslyn 4.8 or later | Roslyn 4.8 or later; interceptors need 4.13 |
| Runtime | .NET 8 to 11, .NET Framework 4.6.2 to 4.8.1 | The same |
Every example runs and prints what it does.
| Example | Shows |
|---|---|
| index | Your first binding |
| observing | WhenChanged, WhenAny, WhenAnyValue, WhenAnyObservable |
| bindings | One-way, two-way, command and interaction bindings |
| properties | ToProperty and [ObservableAsProperty] |
| converters | Built-in type converters |
| custom-converters | Writing your own converters |
| mechanisms | How a property reports a change |
| views | The view locator and IViewFor<T> |
| threading | Which thread a binding writes on |
| xaml | Controls named in MAUI and Avalonia XAML |
| sourcegenerators | Binding to members the attribute generators write |
| unsafe | Run-time expressions |
| setup | Configuration, analyzer and NativeAOT |
| Execute | The attribute generators in use |
| ToPropertyVerification | ToProperty on every runtime target |
| PlatformBindingsVerification | ToProperty feeding real WPF, WinForms and MAUI controls |
| Topic | Where |
|---|---|
| Attribute generators | src/ReactiveUI.SourceGenerators |
| Binding reference: APIs, diagnostics, threading, differences from ReactiveUI | docs/ReactiveUI.Binding.md |
| Benchmarks and current figures | src/benchmarks |
| Contributing and repository layout | CLAUDE.md |
| ReactiveUI handbook | reactiveui.net |
Chris Pulman London, UK |
Glenn Watson Melbourne, Australia |
The project uses the MIT license. Everyone is welcome, including first-time contributors.
- Answer questions on GitHub Discussions
- Improve the docs where something is missing or unclear.
- Contribute code. Read CLAUDE.md first.
Portions of this code are derived from PolySharp and the Microsoft MVVM Community Toolkit.
JetBrains supports ReactiveUI's maintainers through its open source programme. Anthropic supports them with Claude, and OpenAI with Codex.
See our sponsors. All names and logos belong to their owners.