LuminaUI.TreeDataGrid 0.2.0

LuminaUI

中文说明

LuminaUI is an Avalonia 12 component library for desktop, browser, and mobile-style application shells. It provides a shared visual system, reusable controls, navigation primitives, overlays, localization support, and optional themed integrations for ColorPicker, DataGrid, and TreeDataGrid.

The NuGet packages target .NET 8, .NET 9, and .NET 10. Demo hosts remain on .NET 10. The current Avalonia version is 12.0.1.

Packages

Features

• Light and dark theme dictionaries with semantic color, border, surface, glass, and shadow tokens.
• Application shell primitives: LuminaWindow, LuminaTopView, LuminaShell, LuminaPage, dialogs, bottom sheets, and toast surfaces.
• Foundation controls: cards, glass surfaces, group boxes, images, avatars, badges, loading states, skeletons, empty states, and disabled containers.
• Action controls: buttons, toggle buttons, repeat buttons, button groups, drop-down buttons, split buttons, command bars, and pop confirmations.
• Navigation and layout: navigation view, navigation pages, drawer pages, tab pages, tab strips, tab controls, carousel, breadcrumb, split view, and transitioning content.
• Data entry and display: text inputs, OTP input, forms, selection controls, pickers, date range picker, range slider, pagination, descriptions, properties, timeline, steps, indexed lists, and linked categories.
• Localization resources with application-level override support.
• Shared demo project with Desktop, Browser, Android, and iOS hosts.

Quick Start

Reference the packages or projects you need, then register the theme in App.axaml.

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:lumina="clr-namespace:LuminaUI;assembly=LuminaUI"
             xmlns:luminaColorPicker="using:LuminaUI.ColorPicker"
             xmlns:luminaDataGrid="using:LuminaUI.DataGrid"
             xmlns:luminaTreeDataGrid="using:LuminaUI.TreeDataGrid">
  <Application.Styles>
    <FluentTheme />
    <lumina:LuminaTheme />

    
    <luminaColorPicker:LuminaColorPickerTheme />
    <luminaDataGrid:LuminaDataGridTheme />
    <luminaTreeDataGrid:LuminaTreeDataGridTheme />
  </Application.Styles>
</Application>

Use controls with the Lumina namespace:

<lumina:LuminaCard Classes="Glass" Padding="16">
  <StackPanel Spacing="8">
    <TextBlock Classes="SectionTitle" Text="Overview" />
    <Button Classes="Primary" Content="Save" />
  </StackPanel>
</lumina:LuminaCard>

Repository Layout

src/
  LuminaUI/              Core controls, theme resources, localization, shell, and services.
  LuminaUI.ColorPicker/  Optional ColorPicker theme package.
  LuminaUI.DataGrid/     Optional DataGrid theme package.
  LuminaUI.TreeDataGrid/ Optional TreeDataGrid theme package.

demo/
  LuminaUI.Demo/         Shared demo views and view models.
  LuminaUI.Demo.Desktop/ Desktop host and diagnostics entry point.
  LuminaUI.Demo.Browser/ Browser host.
  LuminaUI.Demo.Android/ Android host.
  LuminaUI.Demo.iOS/     iOS host.

MCP diagnostics are intentionally enabled only in demo/LuminaUI.Demo.Desktop.

Build and Run

Restore and build the desktop demo and library projects:

dotnet restore demo/LuminaUI.Demo.Desktop/LuminaUI.Demo.Desktop.csproj
dotnet build demo/LuminaUI.Demo.Desktop/LuminaUI.Demo.Desktop.csproj

Run the desktop demo:

dotnet run --project demo/LuminaUI.Demo.Desktop/LuminaUI.Demo.Desktop.csproj

Run the browser, Android, or iOS hosts when the corresponding .NET workloads are installed. The iOS host requires macOS and Xcode.

dotnet run --project demo/LuminaUI.Demo.Browser/LuminaUI.Demo.Browser.csproj
dotnet build demo/LuminaUI.Demo.Android/LuminaUI.Demo.Android.csproj
dotnet build demo/LuminaUI.Demo.iOS/LuminaUI.Demo.iOS.csproj

After all platform workloads are installed, dotnet build LuminaUI.slnx builds the full workspace.

Create local packages:

dotnet pack src/LuminaUI/LuminaUI.csproj -c Release
dotnet pack src/LuminaUI.ColorPicker/LuminaUI.ColorPicker.csproj -c Release
dotnet pack src/LuminaUI.DataGrid/LuminaUI.DataGrid.csproj -c Release
dotnet pack src/LuminaUI.TreeDataGrid/LuminaUI.TreeDataGrid.csproj -c Release

Release

NuGet publishing and GitHub Releases are handled by the LuminaUI GitHub Actions workflow.

1. Set the repository secret NUGET_API_KEY to a NuGet.org API key.
2. Update LuminaUIVersion in Directory.Build.props to a higher stable version.
3. Push the change to master or main.

git add Directory.Build.props
git commit -m "Release 0.1.0"
git push origin master

If the matching tag does not already exist, the workflow builds the packable projects, publishes .nupkg and .snupkg files to NuGet, builds the Desktop, Browser, Android, and iOS simulator demo release assets, creates the v<version> tag, and publishes a GitHub Release named LuminaUI <version>.

Release notes are generated by GitHub from merged PRs and commits. The first release starts at 0.1.0.

Development Notes

• Keep reusable styling in theme dictionaries and prefer semantic Lumina resources over hard-coded colors.
• Keep optional integrations in their own packages so applications can depend only on the controls they use.
• Prefer MVVM commands and bindable properties in demo pages; use code-behind only for view composition and platform glue.
• When changing visible text, update both English and zh-CN resources.
• Validate UI changes with the desktop demo before packaging.

License

LuminaUI is released under the MIT License. See LICENSE.