G9MAUIControls 1.4.12

dotnet add package G9MAUIControls --version 1.4.12
                    
NuGet\Install-Package G9MAUIControls -Version 1.4.12
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="G9MAUIControls" Version="1.4.12" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="G9MAUIControls" Version="1.4.12" />
                    
Directory.Packages.props
<PackageReference Include="G9MAUIControls" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add G9MAUIControls --version 1.4.12
                    
#r "nuget: G9MAUIControls, 1.4.12"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package G9MAUIControls@1.4.12
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=G9MAUIControls&version=1.4.12
                    
Install as a Cake Addin
#tool nuget:?package=G9MAUIControls&version=1.4.12
                    
Install as a Cake Tool

G9MAUIControls

A dependency-light .NET MAUI control suite, built entirely on public MAUI primitives.

Twenty-five input and feedback controls sharing one outlined-field architecture, a bottom sheet with real per-platform edge-handoff gestures, a popup system, toasts, an animated tab bar, an edge drawer, and a ~110-token light/dark theme engine. Android, iOS, Mac Catalyst and Windows from one codebase, with no #if in the control layer.

dotnet add package G9MAUIControls

What makes it different

Bring your own icon font — or none at all. Every icon slot takes a G9IconSource, which any icon-font enum converts to implicitly (font family = the enum's type name, glyph = its [Description], the convention icon-font generators already emit). The suite's own chrome glyphs are vector paths, not a bundled font, so it looks complete out of the box with zero icon configuration and zero chance of a tofu box.

No shadows, anywhere — and that is a measured decision, not a style. On Android a MAUI Shadow on a view whose platform background isn't a shadow-capable BorderDrawable falls back to drawShadowViaDispatchDraw: an ARGB_8888 bitmap the size of the view, the whole subtree rasterized into it, then software-blurred through a BlurMaskFilter on the UI thread, every draw pass. That produced a hard ANR on real hardware. Elevation here is Stroke + surface-tone steps instead. Full post-mortem in Controls/G9Controls.md §0.

Trim and AOT safe, and verified. No Reflection.Emit, no private-field reads, no runtime code generation. IsTrimmable and IsAotCompatible are declared, and a consuming app published with -p:AndroidLinkMode=Full -p:PublishTrimmed=true, with this assembly rooted, completes with zero IL warnings. That check found four real defects the first time it ran, all fixed — a library build cannot see its dependencies' implementations, so it is the only check that counts.

iOS NativeAOT is not yet verified; the claim above is trimming on Android.

RTL is real, not a FlowDirection you set and hope. Outlined fields physically swap their icon columns; every drawable that mirrors does so itself with its canvas pinned to LTR (a canvas either mirrors itself or the drawable mirrors — never both, or ticks come out backwards).

Three runtime dependencies, and each one earns its place: CommunityToolkit.Mvvm (ObservableObject for the palette, IRelayCommand for the safe buttons), Microsoft.Maui.Controls, and SkiaSharp.Views.Maui.Controls — used only for the tab bar's concave FAB-notch silhouette, which needs a genuinely blurred path on the render thread.


Quick start

// MauiProgram.cs
public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder.UseMauiApp<App>()
           .UseG9SheetView();      // registers the bottom-sheet handler

    // Optional: point the culture facade at your app's language state.
    G9Culture.Configure(
        currentCulture: () => LocalizationManager.CurrentCulture,
        isRtl:          () => LocalizationManager.CurrentCulture.TextInfo.IsRightToLeft);
    G9Culture.LtrFontFamily = "OpenSansRegular";
    G9Culture.RtlFontFamily = "Yekan";

    // Optional: translate the ~50 strings the controls display.
    G9Strings.UseResources(AppDictionary.ResourceManager, keyPrefix: "G9");

    // Optional: use your own icon font everywhere.
    G9IconFonts.Register<MyIcons>(isDefault: true);
    G9Glyphs.Chevron = MyIcons.ExpandMore;

    return builder.Build();
}

Then derive pages from G9PageBase (it applies the control template that hosts the overlay layers) and use the controls:

<g9:G9TextEntry Label="Device name" LeadingIcon="Search" />
<g9:G9ComboBox  Label="Relay channel" ItemsSource="{Binding Channels}" />
<g9:G9Switch    IsOn="{Binding IsEnabled}" />
<g9:G9CheckBox  Text="Include archived" IsChecked="{Binding IncludeArchived}" />
<g9:G9Button    Text="Connect" Variant="Primary" LeadingIcon="{x:Static my:MyIcons.Bluetooth}" />
await G9ToastHelper.ShowToastAsync("Saved", G9ToastType.Success);
var ok = await G9PopupHelper.ShowConfirmAsync("Turn off all relays?", type: G9PopupType.Warning);
G9BottomSheetHelper.ShowG9BottomSheet(content, G9BottomSheetOptions.FitToContentOptions());

// Two detents: opens at a peek, drags open to the CONTENT's own height (capped, then scrolls).
G9BottomSheetHelper.ShowG9BottomSheet(content, G9BottomSheetOptions.DefaultOptions() with
{
    CurrentState = G9BottomSheetState.Peek,
    States = [G9BottomSheetState.Peek, G9BottomSheetState.Medium],
    PeekHeight = 260,
    CollapsedHeight = 260,
    ExpandedFitsContent = true      // ScrollingExpandsSheet is already on by default
});

What's in it

Area Contents
Inputs G9TextEntry G9Editor G9SearchEntry G9PinEntry G9Picker G9ComboBox G9DateTimePicker G9TimeSpanPicker G9RangeSlider G9Switch G9CheckBox G9ChipGroup
Actions G9Button G9IconButton G9SafeButton G9SafeIconButton G9PlusButton G9NavCard G9SwipeView
Structure G9TabView G9Expander G9CascadePanel G9Separator G9TitleWithLine
Feedback G9ProgressBar G9Shimmer G9ActivityIndicator
Overlays G9BottomSheetHelper (+ stacking, morph, fit-to-content, content-sized detents, list picker) · G9PopupHelper (types, input forms, confirm, non-modal draggable) · G9ToastHelper (typed toasts, loaders, progress)
Navigation G9TabBar (animated bottom bar + FAB notch) · G9EdgePanel (edge drawer)
Theming G9Theme G9Palette (~110 tokens) G9LayoutMetrics · {theme:G9Color …} markup extension
Hosting G9PageBase G9ContentViewBase G9PageTemplate (the six-layer overlay z-stack)

Every control folder ships its own .md guide next to the .cs. Start with Controls/G9Controls.md — the architecture guide, including the platform crash-and-pitfall catalog (§15) that documents every WinUI stowed exception, Android gesture-interception and iOS focus quirk this suite has already paid for.


Optional integration hooks

Nothing below is required; each one lights up a feature that a library genuinely cannot do alone.

Hook Enables
G9Culture.Configure / NotifyChanged live language + RTL switching, correct typeface per script
G9Strings.UseResources / UseProvider translating the controls' own strings
G9IconFonts.Register<T> / G9Glyphs.* your icon font throughout the suite
G9ImageFactory.Factory routing bitmap icons through a caching image control
G9Speech.Provider the dictation microphone on G9SearchEntry, G9TextEntry and G9Editor (a tap never opens the keyboard)
G9OutlinedFieldBase.Configure(G9OutlinedFieldSettings) app-wide outlined-field rules — HighlightFilledValue = false rests filled fields in the empty field's greys; per field: FilledValueHighlight. Read back via G9OutlinedFieldBase.Settings. Call before fields are built
G9ToastHelper.RefreshBottomInsetsAsync(animate) live toasts gliding to a changed bottom inset (e.g. after BottomSafeAreaWithTabBar changed because the tab bar hid)
G9AndroidHost.* tap-outside-to-dismiss-keyboard, safe-area re-measure on rotation
G9Preferences.Store redirecting persisted theme + learned sheet heights to your own store
G9SafeCommand.DiagnosticsHandler a "More details" button on error popups
G9SafeCommand.DiagnosticsAvailable gating that button on a runtime setting (a developer mode)
G9BottomSheetHeightSeeds.Seed first-open heights for fit-to-content sheets

Building a control of your own beside the suite? These are public for exactly that: G9Metrics, G9Colors, G9Visuals and G9TabBarMetrics for its measurements; G9ColorExtension.ResolveColor + G9PaletteSubscriptions to paint from the palette and repaint on a theme flip; and G9OverlayHosts.TryGetCurrent(out var host) for the current page's layers — host.OverlayLayer (sheet level), host.ToastLayer (above sheets and popups), host.DevLayer (topmost), and host.Page for its safe-area insets.


License

MIT.

Product Compatible and additional computed target framework versions.
.NET net10.0-android36.0 is compatible.  net10.0-ios26.0 is compatible.  net10.0-maccatalyst26.0 is compatible.  net10.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on G9MAUIControls:

Package Downloads
G9MAUIControls.ProgressOverlay

Adds a bottom-anchored staged-progress overlay to G9MAUIControls: one Running / Canceling / Success / Error state machine plus a draggable minimized bubble, a 44dp cancel target that never routes a cancellation through an error terminal, and a retry affordance on failure. Mounts above the toast stack via the core's IG9BottomAnchoredOverlay seam. No dependencies beyond the core.

G9MAUIControls.Barcode

Adds G9BarcodeTextEntry to G9MAUIControls: an outlined text field with an integrated camera scan affordance, busy/accepted/error trailing states, optional format validation, and a multi-scan session mode. Ships separately because camera scanning requires a native camera stack and a camera permission, which the core deliberately does not depend on.

G9MAUIControls.IntroCarousel

Adds G9IntroCarousel to G9MAUIControls: a swipeable onboarding / intro carousel whose slides can be images or video, with page indicators, a skip affordance, and correct RTL paging. Ships separately because video playback requires CommunityToolkit.Maui.MediaElement and a platform media stack, which the core deliberately does not depend on.

G9AppDiagnostic.Maui

Tester mode and the live diagnostic channel for .NET MAUI apps: capture panel, screen and voice recording, screenshots, gesture, timeline, drafts and a resumable send queue; presence, live logs, screenshots, remote control, the SQL console and diagnostic bundles (backups, reports, restore) to a G9AppDiagnostic gateway.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.4.12 120 11/16/2026
1.4.11 143 11/10/2026
1.4.10 150 11/9/2026
1.4.9 136 11/9/2026
1.4.8 143 11/8/2026
1.4.7 161 11/4/2026
1.4.6 151 11/3/2026
1.4.5 152 11/2/2026
1.4.4 161 11/2/2026
1.4.3 317 10/21/2026
1.4.2 190 10/13/2026
1.4.1 161 10/13/2026
1.4.0 174 10/5/2026
1.3.0 177 10/3/2026
1.2.0 178 9/27/2026
1.1.0 186 9/21/2026
1.0.14 220 9/12/2026
1.0.13 217 9/8/2026
1.0.12 200 9/8/2026
1.0.10 215 9/7/2026
Loading failed

1.4.12
       - A close-top (or the hardware back) during a stacked sheet's stage-before-show hold closes THAT sheet, not the one under it; a staged sheet counts as the top.
       - An empty or blank label no longer hides an outlined field's placeholder.