English | 简体中文

LuminaForms

A WinForms compatibility layer for .NET 10 and Native AOT. The package and namespace remain Lumina.Forms. The goal is to migrate existing applications through reference and namespace changes while preserving familiar controls, events, properties, and designer code.

The current implementation uses native Windows controls. Common controls and AOT publishing have initial validation; full WinForms compatibility is still in progress. Native Linux GTK4 and macOS AppKit backends are planned and require prototypes.

• Project requirements: product goals, compatibility principles, and the Windows official / Linux custom Drawing strategy.
• Roadmap: priorities and milestones.
• Per-control plans: tasks, three-platform analysis, and actual change history.
• 98% acceptance criteria: properties, events, and behavior measured separately.
• Project reassessment.
• Migration guide · Support matrix.

NativeFormsDemo keeps two targets: net10.0-windows uses real WinForms and preserves Visual Studio designer support; net10.0 uses Lumina.Forms and validates Native AOT. Static layouts stay in .Designer.cs / .resx.

dotnet build Lumina.slnx -c Release
dotnet test Lumina.Tests/Lumina.Tests.csproj -c Release
dotnet publish NativeFormsDemo/NativeFormsDemo.csproj -f net10.0 -r win-x64 -c Release

The main solution retains Lumina.Forms, Lumina.Forms.Analyzers, Lumina.Core, Lumina.Ext.WinForms, Lumina.Tests, and two validation samples. Core and the WinForms adapter preserve the existing Windows theme APIs.

The WPF adapter has been removed. The standalone effects application, DWM injection, and effects showcase remain in Lumina.Effects.slnx for separate builds. See the consolidation decisions. Historical effects documentation is separate from control compatibility status.

MIT · Third-party notices