Versions
1.0.0 is the SemVer lock. Public 1.x APIs stay source-compatible; 1.1.0+ may add surfaces; breaking changes wait for 2.0.0. Current public packages are 1.0.0. Shipped 0.6.1 APIs plus UseAuth<TChallenge>() are the contract. From 0.6.1-preview, install without --prerelease and replace GuardedNavigator reconstruction with UseAuth.
| Version | Meaning |
|---|---|
| 0.1.0-design | Documents + solution skeleton |
| 0.1.0-preview | Phase 1 — Core + host + Shell navigator + dialogs + validation + pagination |
| 0.3.0-preview | Phase 2 — page host, URI stack, toast, multi-window |
| 0.4.0-preview | Phase 3 — forms, Reactive, cache policies, pipeline, scopes |
| 0.5.0-preview | Phases 4–5 — generators, persist/auth, productization |
| 0.6.0-preview | Device-safe marshal, weak CanExecuteChanged, overlay toasts, host/auth/forms UX |
| 0.6.1-preview | Host-safe navigator, UseNavigationPage + replace-root, SectionHost, SnapshotCollection |
| 1.0.0 | Phases 6–7 — 15-minute path, Playground, UseAuth, SemVer lock (current) |
| 1.1.0 | Phase 8 — one path (generators, registration, forms, nav-args), analyzers, dotnet new |
| 1.2.0 | Phase 9 — Shell parity, modules, modal stack, sibling host adapters |
| 1.3.0 | Phase 10 — device numbers, trim, zero-reflection policy, production post-mortem |
Shipped (1.0.0)
- Phase 1: ObservableModel, commands, ViewModel lifecycle, AsyncState, Outcome, MessageHub, AddMvvmExpress / UseMvvmExpress, leak and scale tests.
- Phase 2: INavigator, MauiShellNavigator, MauiPageNavigator, URI stack, dictionary/URI args, IWindowContext, GuardedNavigator, IDialogs, MauiNotifier toast, IValidator, PagedCollection, SearchQuery.
- Phase 3: FormViewModel, IPropertyObservable / CombineLatest, ICachedFetcher, IOperationExecutor, command debounce / throttle / queue, child composition, IViewModelScopeFactory, IFeatureSwitch / IPermissionGate / IFileStore / IMediaPicker.
- Phase 4: [Notify], command / register / route / persist / auth attributes, AddGeneratedViewModels, DeepLinkRouteMap sample, CommunityToolkitMessageHub, IStateStore, IMvvmExpressDiagnostics.
- Phase 5: migration guides, AOT/trim notes, BenchmarkDotNet, Testing fakes, ScopedNavigator pop-GC, NuGet SourceLink / snupkg / tags.
- 0.6.0: UI-thread marshal, no-throw ICommand.Execute, weak CanExecuteChanged, Window.AddOverlay toasts, UseShell / UseDialogs, dirty confirm, GuardedNavigatorOptions, IAccountService, ModuleInitializer routes, AuthApp, Validation trim roots.
- 0.6.1: Navigators hop before new Page(), UseNavigationPage + ResetAsync replace-root, SectionHostViewModel, SnapshotCollection, SearchQuery.CommittedText, FormViewModel.Bind, CoalescingDispatcher, ChatHost sample.
- 1.0.0: UseAuth<TChallenge>() / AddAuth<TChallenge>(), 15-minute getting started, cheat sheet, cookbook, Playground, design-review sign-off, SemVer lock.
SemVer contract
Design-review sign-off is recorded (2026-09-02). Accepted 1.0 scope: host-process BenchmarkDotNet and ScaleProfile rather than device RSS; in-memory pop-GC rather than a device-window detach run; Mac Catalyst and Windows are single-window host targets on Host / Navigation / Dialogs. Sibling capability plugins remain Android + iOS. Phases 8–10 may deprecate, not break, 1.0 types.
Next
Phase 8 (1.1.0) is one vocabulary for generators, registration, forms, and nav-args, plus CommunityToolkit interop, three analyzers, and dotnet new. Phase 9 (1.2.0) is Shell parity, modules, and modal stack. Phase 10 (1.3.0) is device numbers, trim, and a production post-mortem.
Explicitly deferred past 1.0
- Prism-style regions.
- ReactiveUI IScreen routing as a first-class host.
- A built-in remote feature-flag or auth provider (use FeatureFlags / SecureSession).
- Multi-window desktop, desktop toast QA, and a Windows nupkg RID when packing on macOS.
- A bottom-sheet control library (Dialogs stays an abstraction).
- A Visual Studio binding debugger visualizer.