Skip to content
Nuvyntra Labs

Lumina UI library

UIKit(MAUI)

Lumina UI kit — NV* controls and page recipes for .NET MAUI

NuvyntraLabs.UIKit · 1.6.0

Lumina-themed UI library for .NET MAUI on Android, iOS, Mac Catalyst, and Windows. One package: NV* controls, design tokens, and page recipes. This is a UI library, not a MauiEssentials runtime plugin.

Install

dotnet add package NuvyntraLabs.UIKit

builder
    .UseMauiApp<App>()
    .UseNuvyntraUIKit()

nuget.org publish is pipeline-owned — never dotnet nuget push from a local clone. XAML prefix nv maps to http://nuvyntralabs.com/uikit.

Quick start

xmlns:nv="http://nuvyntralabs.com/uikit"

NVTheme.Current.SetTypeScale(1);
NVTheme.Current.SetFlowDirection(FlowDirection.MatchParent);

<nv:NVCheckBox Text="Accept terms" IsChecked="{Binding Accept}" />
<nv:NVRadioButton GroupName="Plan" Text="Monthly" />
<nv:NVInputField Label="Email" Text="{Binding Email}" />
<nv:NVButton Text="Continue" Variant="Filled" Command="{Binding Submit}" />
<nv:NVCommandPalette Query="{Binding Query}" />
<nv:NVSignInView />
<nv:NVInvoiceView />

Overview

NuvyntraLabs.UIKit 1.6.0 is the Lumina catalog for a typical MAUI app: foundation tokens, 201 NV* controls from primitives through advanced and Next chrome, and 66 NV*View page recipes. Register with UseNuvyntraUIKit(), then use xmlns nv. 1.6.0 is a Lumina look refresh — lifted fills, hairline, glow, recessed fields — plus NVChrome paint recipes and derived tokens. Hosts that pin 1.5.x keep compiling. 1.5.0 renamed NVEmailField to NVInputField. 1.5.1 added type scale, RTL flow, contrast-safe ink, and Escape / Ctrl+K overlay shortcuts. Kit-level APIs stay a working Lumina surface — not Telerik or Syncfusion parity. PDF, Docx, and Spreadsheet are viewers. NVBarcode generates; it does not scan. Compose FormValidation, KeyboardManager, and MVVMExpress at the host. This library does not PackageReference Plugin.Maui.*.

Capabilities

  • One library: NV* controls, Lumina tokens, and page recipes. Prefix NV, xmlns http://nuvyntralabs.com/uikit.
  • UseNuvyntraUIKit() registers fonts and the Lumina theme (NVTheme, NVTokens, NVChrome, Outfit).
  • 201 controls plus helpers NVRadioGroup and NVFormField — basics through advanced, plus 1.2 / 1.3 chrome.
  • 66 NV*View page recipes for auth, commerce, content, social, files, system, invoice, call, and address screens.
  • 1.6.0 look: lifted fills, hairline strokes, accent glow, recessed fields, and richer chips / cards / overlays. NVChrome recipes (Lift, Soft, Shadow, Glow, PaintCard, PaintField) plus NVTheme tokens SurfaceRaised, SurfaceSunken, AccentSoft / AccentDeep / AccentLift, Hairline, Highlight, Scrim, and Mix().
  • 1.5.1 theming: NVTheme.Current.SetTypeScale(0.8–2) and SetFlowDirection. RTL flips start padding, carousel swipe, and chevrons. Contrast picks OnAccent / On(fill) when white fails 4.5:1.
  • OverlayHost.TryHandleKey(Escape) and NVCommandPalette.TryHandleShortcut(Ctrl/Cmd+K). Blocking paywall ignores Escape.
  • 1.4 deepens lists (selection, groups, swipe), grids (filter, sort, frozen columns, paging), charts, calendar, and media.
  • Targets net10.0, Android API 21+, iOS 15+, Mac Catalyst 15+, and Windows 10.0.17763+ (packed on Windows).
  • MIT. Font is Outfit (OFL). Look is original Lumina — not a Syncfusion or Telerik theme.

201 controls + 66 page recipes

Each control has a details page with XAML (every attribute) and an explanation of that attribute. Start at the component reference. Source list: UIKitLib.md.

LayerTypesRole
FoundationNVTheme, NVTokens, NVChrome, NVTypography, NVIcons, NVMotion, NVDensity, NVVisualState, NVAccessibilityStatic / singleton helpers. Not XAML views.
PrimitivesNVSurface, NVDivider, NVIcon, NVAvatar, NVBadge, NVSkeleton, NVOverlay, NVInteractiveViewerThemed paper, glyphs, overlays, and zoom/pan.
ActionsNVButton, NVCheckBox, NVRadioButton, NVRadioGroup, NVIconButtonFilled / tonal / outline / ghost / danger buttons and selection.
InputsNVTextField, NVInputField, NVPasswordStrength, NVPinPad, NVDateRangePicker, NVFormFieldLabeled fields with helper / error chrome.
Feedback / navNVBanner, NVEmptyView, NVTabView, NVBottomSheet, NVNavigationView, NVAppScaffoldStatus, sheets, tabs, and app chrome.
Data / vizNVDataGrid, NVChart, NVCalendar, NVKanban, NVGanttGrids, charts, calendar, and planning surfaces.
Social / mediaNVChat, NVComposer, NVVideoPlayer, NVWebView, NVPdfViewerChat chrome plus media viewers — not playback or document engines.
AdvancedNVMasterDetail, NVLockPad, NVBiometricGate, NVWizard, NVTicketCompositions. Real biometrics stay on the host plugin.
Next (1.2 / 1.3)NVCommandPalette, NVHeatCalendar, NVSpeedDial, NVDiffView, NVCallBar, NVReviewPromptApp chrome added after 1.0 — palette, paywall, pivot, diff, call, review.
PagesNVSignInView … NVAddressFormView66 content recipes. They set titles and seed demo children.

Page recipes

Content compositions over the controls above. They do not add new bindable names.

  • Auth

    NVSignInView, NVSignUpView, NVForgotPasswordView, NVResetPasswordView, NVSocialSignInView, NVTabbedAuthView, NVProfileSetupView, NVWalkthroughView

  • Commerce

    NVCategoryView, NVCatalogView, NVProductHomeView, NVProductDetailView, NVCartView, NVWishlistView, NVCheckoutView, NVCardPaymentView, NVSavedCardsView, NVPaymentResultView, NVOrdersView, NVOrderHistoryView

  • Content

    NVArticleFeedView, NVArticleDetailView, NVMyArticlesView, NVReviewView, NVContactView, NVAboutView, NVFaqView, NVBookmarksView

  • Social

    NVInboxView, NVConversationView, NVSocialProfileView, NVPeopleListView, NVAuthorProfileView, NVHealthProfileView, NVChatProfileView

  • Files

    NVNavigationHubView, NVMediaLibraryView, NVPlaylistView, NVFileExplorerView, NVDocumentsView, NVSuggestionsView

  • System

    NVStatusView, NVSettingsView, NVHelpView, NVNotificationsView, NVDeliveryTrackView, NVAddressBookView, NVBookingView, NVDashboardView

  • Extras

    NVPinLockView, NVForceUpdateView, NVSearchResultsView, NVFilterSheetView, NVMediaPlayerView, NVSplitInboxView, NVOnboardingPermissionsView, NVOrderSummaryView

  • Next (1.2)

    NVInvoiceView, NVReceiptView, NVCompareView, NVStoreLocatorView, NVSubscriptionView, NVWhatsNewView

  • Next (1.3)

    NVConflictResolveView, NVCallView, NVAddressFormView

Compose at the host

Platforms

  • net10.0

    Shared library TFM

  • Android

    API 21+

  • iOS

    15+

  • Mac Catalyst

    15+

  • Windows

    10.0.17763+ (TFM 10.0.19041.0; packed on Windows)

Out of scope

PDF / Word / Excel engines, camera barcode scan, paid map tiles, and real biometrics stay on host plugins (Printing, MediaPipeline, GeoLocator, Biometric). The sample NuvyntraLabs.UIKit.Sample is a MAUI Shell flyout: Theme through Media, plus Basics, Advanced, Next (1.2), and every page recipe.

Discussion

Comment on UIKit(MAUI). The thread lives on this component's GitHub repository (nuvyntralabs/NuvyntraLabs.UIKit). Sign in with GitHub — Giscus uses Discussions, Utterances uses Issues.