README.md
June 14, 2026 ยท View on GitHub
UraniumUI
The open-source presentation framework for production .NET MAUI apps.
Build app-ready MAUI screens with Material controls, dynamic forms, dialogs, data components, theming, icons, overlays, and effects without leaving XAML or MVVM.
Documentation | NuGet | Templates | Demo App | Discord
UraniumUI is a free and open-source presentation layer for .NET MAUI. It fills the UI gaps plain MAUI leaves to every team: Material-styled inputs and buttons, generated forms, validation mapping, data grids, tree views, tab views, dialogs, bottom sheets, backdrops, icons, blur effects, code views, templates, and app-ready presentation patterns.
You keep writing regular .NET MAUI: XAML, ContentPage, Shell, bindings, styles, resources, handlers, dependency injection, MVVM, and platform APIs. UraniumUI attaches to that model instead of replacing it.
It is not just a collection of styled controls and it is not only an AutoFormView package. UraniumUI provides the building blocks for real app screens: form workflows, data-heavy views, hierarchical navigation, app surfaces, visual system resources, native-MAUI handlers, and extensibility points for your own controls.
Who It Is For
- .NET MAUI teams building production line-of-business, admin, data-entry, or internal tools.
- Teams that want a Material presentation layer without moving away from XAML, MVVM, resources, or MAUI handlers.
- Apps that need more than basic controls: validation-aware fields, data grids, tree views, tabs, dialogs, bottom sheets, and reusable page surfaces.
- Developers who want incremental adoption: use one control, add one package, or start from a full template.
No Framework Tax
Some UI stacks ask you to move your app into their way of building software. UraniumUI does not.
There is no required base ViewModel, proprietary navigation model, custom application layer, generated project structure, or new UI DSL. Adopt one control, a validation-aware field set, or a full Material presentation layer. Your app remains a MAUI app.
Plain MAUI in, better UI out.
The Mental Model
.NET MAUI gives you the platform foundation. UraniumUI adds the presentation architecture that most production apps end up rebuilding.
| App need | UraniumUI provides |
|---|---|
| Build forms quickly | AutoFormView generates editors from your model, while FormView handles validation, submit/reset behavior, busy state, and validation summaries. |
| Validate consistently | InputKit validation, DataAnnotations integration, async validators, and property-path mapping for generated or hand-written fields. |
| Build data screens | DataGrid, Paginator, TreeView, TabView, Select, Dropdown, CalendarView, and Material input fields for real application workflows. |
| Add app surfaces | IDialogService, modal-page dialogs, Mopups and CommunityToolkit dialog providers, form dialogs, BottomSheetView, and BackdropView. |
| Standardize presentation | Material color and style resources, light/dark tokens, button variants, containers, dividers, elevation, icon packs, cascading styles, and blur effects. |
| Keep UI native and flexible | Controls and handlers built on MAUI primitives instead of a closed rendering stack or proprietary application model. |
| Escape the defaults | Replace generated editors, customize templates, override styles, add page attachments, create themes, or use native MAUI APIs directly. |
Quick Start
Start a New App
Install the templates and create a ready-to-run UraniumUI project:
dotnet new install UraniumUI.Templates
dotnet new uraniumui-app -n MyMauiApp
For a lighter starter project:
dotnet new uraniumui-blank-app -n MyMauiApp
You can also generate a UraniumContentPage item:
dotnet new uraniumcontentpage -n CustomerPage -na MyMauiApp
Templates can configure icon packages, dialog integration, and blur support during project creation.
Add UraniumUI to an Existing App
Install the Material package. It references the core UraniumUI package and configures Material controls and AutoFormView editor mappings.
dotnet add package UraniumUI.Material
Register UraniumUI in MauiProgram.cs:
using UraniumUI;
builder
.UseMauiApp<App>()
.UseUraniumUI()
.UseUraniumUIMaterial();
Add Material resources in App.xaml:
<Application xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:material="http://schemas.enisn-projects.io/dotnet/maui/uraniumui/material"
x:Class="MyMauiApp.App">
<Application.Resources>
<ResourceDictionary>
<ResourceDictionary.MergedDictionaries>
<ResourceDictionary x:Name="appColors" Source="Resources/Styles/Colors.xaml" />
<ResourceDictionary x:Name="appStyles" Source="Resources/Styles/Styles.xaml" />
<material:StyleResource ColorsOverride="{x:Reference appColors}" BasedOn="{x:Reference appStyles}" />
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
</Application.Resources>
</Application>
Read the full onboarding guide: Getting Started.
What You Can Build
UraniumUI is useful when you need to ship complete MAUI screens, not just one-off controls. These are common places where it removes repeated UI plumbing.
Forms Without Boilerplate
Instead of hand-writing every field, binding, validation message, and layout row, describe the form with your model and let UraniumUI generate the editable UI.
using System.ComponentModel.DataAnnotations;
public class RegisterViewModel
{
[Required]
[EmailAddress]
public string Email { get; set; } = string.Empty;
[Required]
public string FullName { get; set; } = string.Empty;
[Range(1, 10)]
public int NumberOfSeats { get; set; }
[Display(Name = "I accept the terms and conditions")]
public bool AcceptedTerms { get; set; }
}
<uranium:AutoFormView Source="{Binding .}" />
Enable DataAnnotations validation once:
dotnet add package UraniumUI.Validations.DataAnnotations
using UraniumUI.Options;
using UraniumUI.Validations;
builder.Services.Configure<AutoFormViewOptions>(options =>
{
options.ValidationFactory = DataAnnotationValidation.CreateValidations;
});
The same model can now drive generated editors, display names, and validation messages. If a screen needs custom behavior, override the editor mapping, change the generated layout, or replace a generated field with your own MAUI view.
Learn more: AutoFormView and DataAnnotations validation.
Data Screens Without Rebuilding Tables
Bind a collection and let DataGrid render rows, headers, empty states, selection columns, templates, and auto-generated columns when you want them.
<material:DataGrid ItemsSource="{Binding Customers}" UseAutoColumns="True" />
When the screen needs more control, define explicit DataGridColumn items, cell templates, header templates, selection columns, and pair the grid with Paginator.
Learn more: DataGrid and Paginator.
Navigation, Hierarchies, And Multi-Section UI
Use higher-level controls for the patterns that show up in real apps: hierarchical data, tabbed content, searchable/selectable lists, calendars, expanders, and dropdowns.
<material:TreeView ItemsSource="{Binding Nodes}" SelectionMode="Multiple" />
<material:TabView>
<material:TabItem Title="Overview">
<material:TabItem.ContentTemplate>
<DataTemplate>
<Label Text="Overview content" />
</DataTemplate>
</material:TabItem.ContentTemplate>
</material:TabItem>
</material:TabView>
TreeView supports custom item templates, expansion state binding, lazy loading, single/multiple selection, and hierarchical checkbox selection. TabView supports lazy content templates, custom headers, dynamic tabs, placement options, and caching strategies.
Learn more: TreeView, TabView, Select, and CalendarView.
App Surfaces, Dialogs, And Visual Polish
Use UraniumContentPage attachments for surfaces that belong to the page instead of manually layering grids and overlays.
<uranium:UraniumContentPage.Attachments>
<material:BottomSheetView IsPresented="{Binding IsFiltersOpen}">
<VerticalStackLayout Padding="24" Spacing="16">
<Label Text="Filters" FontAttributes="Bold" />
<material:TextField Title="Search" Text="{Binding SearchText}" />
</VerticalStackLayout>
</material:BottomSheetView>
</uranium:UraniumContentPage.Attachments>
The same presentation layer includes BackdropView, IDialogService, form dialogs, prompt dialogs, progress dialogs, optional Mopups and CommunityToolkit providers, Material color/style resources, icon packages, and blur effects.
Learn more: Bottom Sheet, Backdrop, Dialogs, and Blurs.
Feature Map
| Area | What you get | Docs |
|---|---|---|
| Forms and validation | FormView, AutoFormView, generated editors, validation summaries, busy state, async validators, ValidationPath, InputKit validation, DataAnnotations integration, and form dialogs. | AutoFormView, Validations |
| Core infrastructure | UraniumContentPage, page attachments, StatefulContentView, DynamicContentView, GridLayout, MAUI handlers, and primitives for custom interactive controls. | UraniumContentPage, StatefulContentView |
| Core components | CalendarView, Select, Dropdown, AutoCompleteView, ExpanderView, and SelectableLabel. | Core Components |
| Material inputs | InputField, TextField, EditorField, AutoCompleteTextField, DropdownField, SelectField, PickerField, MultiplePickerField, DatePickerField, TimePickerField, validation display, clear buttons, icons, and floating-label field styling. | Material Inputs |
| Buttons and selection | Material button styles, ButtonView, Chip, CheckBox, RadioButton, and RadioButtonGroupView. | Buttons, Chip |
| Data and navigation | DataGrid, DataGridColumn, DataGridSelectionColumn, Paginator, TreeView, TreeViewHierarchicalSelectBehavior, TabView, and TabItem. | DataGrid, TreeView, TabView |
| Surfaces and overlays | BottomSheetView, BackdropView, IDialogService, default modal-page dialogs, Mopups provider, CommunityToolkit provider, confirmation prompts, text/date prompts, progress dialogs, custom view dialogs, and form dialogs. | Bottom Sheet, Backdrop, Dialogs |
| Styling, theming, and effects | Material color resources, style resources, light/dark tokens, cascading styling, custom themes, containers, dividers, elevation, Material Symbols, Font Awesome, Fluent icons, and blur/acrylic effects. | Color System, Icons, Blurs |
| Web components | CodeView for WebView-backed syntax-highlighted code rendering with bundled highlight.js assets and themes. | CodeView |
| Templates | Full app template, blank app template, and UraniumContentPage item template with optional icon, dialog, and blur setup. | Getting Started |
Package Map
| Package | Purpose |
|---|---|
UraniumUI | Core controls, handlers, FormView, AutoFormView, dialogs, page infrastructure, layouts, and extensibility primitives. |
UraniumUI.Material | Material presentation layer, theme resources, Material controls, app surfaces, data/navigation controls, and Material editor mappings for generated forms. |
UraniumUI.Validations.DataAnnotations | DataAnnotations integration for manual forms and generated editors. |
UraniumUI.Dialogs.Mopups | IDialogService implementation backed by Mopups. |
UraniumUI.Dialogs.CommunityToolkit | IDialogService implementation backed by .NET MAUI Community Toolkit popups. |
UraniumUI.Icons.MaterialSymbols | Material Symbols icon fonts, font aliases, and glyph helpers for outlined, rounded, sharp, and filled variants. |
UraniumUI.Icons.FontAwesome | Font Awesome Free regular and solid icon fonts with glyph helpers. |
UraniumUI.Icons.SegoeFluent | Segoe Fluent icon font and glyph helpers for Fluent/Windows-aligned apps. |
UraniumUI.Icons.MaterialIcons | Legacy Material Icons package; prefer UraniumUI.Icons.MaterialSymbols for new apps. |
UraniumUI.Blurs | Cross-platform blur/acrylic effects and optional blurred dialog surfaces. |
UraniumUI.WebComponents | WebView-backed components such as CodeView for syntax-highlighted code rendering. |
UraniumUI.Templates | Project and item templates for new UraniumUI apps and pages. |
Supported Targets
| Target | Support |
|---|---|
| UraniumUI v3.0+ | .NET 10 |
| .NET 9 | Supported up to UraniumUI v2.16.0 |
| .NET 8 | Use UraniumUI v2.6 through v2.12 |
| .NET 6 and .NET 7 | Use UraniumUI v2.5 |
Supported MAUI platforms:
- Android
- iOS
- Mac Catalyst
- Windows
- Tizen, with limited support and optional setup
Demo App
The repository includes a runnable MAUI demo app in demo/UraniumApp. It wires the same registration path used by real apps and contains pages for Material inputs, buttons, chips, DataGrid, TreeView, TabView, BottomSheetView, BackdropView, dialogs, validations, AutoFormView, icons, blurs, calendar, dropdown, select, expander, and layout primitives.
Documentation
- Getting Started
- AutoFormView
- Validations
- Material Theme
- DataGrid
- TreeView
- TabView
- Dialogs
- Icons
- Blurs
- CodeView
Contributing
We welcome contributions and suggestions. Please read the contributing guide.
You may consider checking out issues with the good first issue label to make your first contribution.
Roadmap
See the milestones section in the repository.
License
This project is licensed under the Apache License. See the LICENSE file for details.
Backers
| Special thanks to project supporters ๐ |
|---|
| YvanBrunel |
| Hottemax |
| tjlangenkamp |
| C00lzer0 |
| Eric |
| Volker Busch |
| gpproton |
| kmaclagan-pcl |
| @Geramy |
| Malko_Josue |
| Nawa |
| JohnStabler |
| jfversluis |
| Lucasbk123 |
| laszlodaniel |
| codychaplin |
| Juliette Dianne Moss |
| Simon Brettschneider |
| JohnCKoenig |
| 7 M O X D |
| Anonymous people 6โ๏ธ |
Donations are spent on infrastructure costs such as the documentation website.
Support
If UraniumUI helps you ship .NET MAUI apps, you can support the project on BuyMeACoffee.