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 needUraniumUI provides
Build forms quicklyAutoFormView generates editors from your model, while FormView handles validation, submit/reset behavior, busy state, and validation summaries.
Validate consistentlyInputKit validation, DataAnnotations integration, async validators, and property-path mapping for generated or hand-written fields.
Build data screensDataGrid, Paginator, TreeView, TabView, Select, Dropdown, CalendarView, and Material input fields for real application workflows.
Add app surfacesIDialogService, modal-page dialogs, Mopups and CommunityToolkit dialog providers, form dialogs, BottomSheetView, and BackdropView.
Standardize presentationMaterial color and style resources, light/dark tokens, button variants, containers, dividers, elevation, icon packs, cascading styles, and blur effects.
Keep UI native and flexibleControls and handlers built on MAUI primitives instead of a closed rendering stack or proprietary application model.
Escape the defaultsReplace 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.

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

AreaWhat you getDocs
Forms and validationFormView, AutoFormView, generated editors, validation summaries, busy state, async validators, ValidationPath, InputKit validation, DataAnnotations integration, and form dialogs.AutoFormView, Validations
Core infrastructureUraniumContentPage, page attachments, StatefulContentView, DynamicContentView, GridLayout, MAUI handlers, and primitives for custom interactive controls.UraniumContentPage, StatefulContentView
Core componentsCalendarView, Select, Dropdown, AutoCompleteView, ExpanderView, and SelectableLabel.Core Components
Material inputsInputField, TextField, EditorField, AutoCompleteTextField, DropdownField, SelectField, PickerField, MultiplePickerField, DatePickerField, TimePickerField, validation display, clear buttons, icons, and floating-label field styling.Material Inputs
Buttons and selectionMaterial button styles, ButtonView, Chip, CheckBox, RadioButton, and RadioButtonGroupView.Buttons, Chip
Data and navigationDataGrid, DataGridColumn, DataGridSelectionColumn, Paginator, TreeView, TreeViewHierarchicalSelectBehavior, TabView, and TabItem.DataGrid, TreeView, TabView
Surfaces and overlaysBottomSheetView, 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 effectsMaterial 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 componentsCodeView for WebView-backed syntax-highlighted code rendering with bundled highlight.js assets and themes.CodeView
TemplatesFull app template, blank app template, and UraniumContentPage item template with optional icon, dialog, and blur setup.Getting Started

Package Map

PackagePurpose
UraniumUICore controls, handlers, FormView, AutoFormView, dialogs, page infrastructure, layouts, and extensibility primitives.
UraniumUI.MaterialMaterial presentation layer, theme resources, Material controls, app surfaces, data/navigation controls, and Material editor mappings for generated forms.
UraniumUI.Validations.DataAnnotationsDataAnnotations integration for manual forms and generated editors.
UraniumUI.Dialogs.MopupsIDialogService implementation backed by Mopups.
UraniumUI.Dialogs.CommunityToolkitIDialogService implementation backed by .NET MAUI Community Toolkit popups.
UraniumUI.Icons.MaterialSymbolsMaterial Symbols icon fonts, font aliases, and glyph helpers for outlined, rounded, sharp, and filled variants.
UraniumUI.Icons.FontAwesomeFont Awesome Free regular and solid icon fonts with glyph helpers.
UraniumUI.Icons.SegoeFluentSegoe Fluent icon font and glyph helpers for Fluent/Windows-aligned apps.
UraniumUI.Icons.MaterialIconsLegacy Material Icons package; prefer UraniumUI.Icons.MaterialSymbols for new apps.
UraniumUI.BlursCross-platform blur/acrylic effects and optional blurred dialog surfaces.
UraniumUI.WebComponentsWebView-backed components such as CodeView for syntax-highlighted code rendering.
UraniumUI.TemplatesProject and item templates for new UraniumUI apps and pages.

Supported Targets

TargetSupport
UraniumUI v3.0+.NET 10
.NET 9Supported up to UraniumUI v2.16.0
.NET 8Use UraniumUI v2.6 through v2.12
.NET 6 and .NET 7Use 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

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.



Activity

Repobeats analytics image