Introduction

Blazing.Mvvm brings MVVM patterns to Blazor through tight integration with CommunityToolkit.Mvvm. It helps you build Blazor applications with ViewModel-first navigation, automatic ViewModel discovery and registration, parameter resolution between views and ViewModels, validation support, and reusable base components for common Blazor hosting models.

What Blazing.Mvvm gives you

• ViewModel-aware base components such as MvvmComponentBase, MvvmOwningComponentBase, and MvvmLayoutComponentBase
• Base classes such as ViewModelBase, RecipientViewModelBase, and ValidatorViewModelBase
• Strongly typed navigation with MvvmNavigationManager, MvvmNavLink, and MvvmKeyNavLink
• Parameter resolution and automatic two-way binding support
• Validation support through MvvmObservableValidator
• Sample applications that show the library across multiple hosting models

Supported hosting models

Blazing.Mvvm supports:

• Blazor Server
• Blazor WebAssembly
• Blazor Web App
• Blazor Hybrid for WPF, WinForms, MAUI, and Avalonia

Package lineup

Depending on what you need, the repository ships multiple packages:

• Blazing.Mvvm for the main MVVM integration, components, navigation, and helpers
• Blazing.Mvvm.Base for shared primitives and foundational building blocks
• Blazing.Mvvm.Analyzers for analyzer rules that help keep ViewModel usage and registration consistent

Documentation map

Start with the page that matches your goal:

• First-time setup: Getting Started
• Understand base classes and registration: View Models
• Wire component parameters to ViewModels: Parameter Resolution and Two-Way Binding
• Navigate by ViewModel instead of route strings: MVVM Navigation
• Enable validation in forms: MVVM Validation
• Run behind subpaths or reverse proxies: Subpath Hosting
• Browse examples: Sample Projects

Repository reference

The repository README.md remains the broad project overview and quick reference:

• Repository README
• Version History

Next steps

1. Install the package and wire up services in Getting Started.
2. Review View Models to choose the right base class and registration pattern.
3. Move to MVVM Navigation and MVVM Validation as your app grows.