LumaFlow is a declarative, reactive C# UI framework built on top of Unity UI Toolkit.

It provides a clearer application-level model for composing complex interfaces while keeping Unity's native UI Toolkit responsible for rendering, layout, input, focus, and virtualization.

Instead of manually managing large VisualElement trees, LumaFlow lets you describe interfaces using typed, composable widgets and explicit reactive state. Compatible updates are reconciled against retained UI Toolkit elements, allowing local state and native identity to remain stable.

Core features:

• Declarative widget composition in C#

• Reactive State<T> and scoped rebuilds

• Local reconciliation with retained UI Toolkit elements

• Rows, columns, constraints, scrolling, responsive layouts and adaptive scaffolds

• Theming and state-aware component styling

• Controlled forms and input components

• Retained navigation, drawers, dialogs, popovers, tooltips and overlays

• Native UI Toolkit ListView virtualization for large collections

• Typed icons and image primitives

• Implicit animations and tween-based animation building blocks

• Accessibility semantics, focus traversal and scalable text

• Localization support

• Widget Inspector and runtime diagnostics

• Native UI Toolkit escape hatch for direct integration when required

Native by design:

LumaFlow does not introduce a custom renderer, JavaScript runtime, or second layout engine. Widgets ultimately map to Unity VisualElement instances and continue to use native UI Toolkit behavior underneath.

This means existing Unity concepts such as Flexbox/Yoga layout, input, focus handling and native list virtualization remain part of the underlying system.

Designed for application-style interfaces:

LumaFlow is aimed at projects that need more structure than manually assembled UI Toolkit hierarchies: dashboards, tools, launchers, configuration interfaces, runtime applications and complex game UI.

The package includes documentation and a Getting Started sample demonstrating the core composition and state model.

Requirements:

• Unity 6 or newer

• Unity UI Toolkit

Current status:

LumaFlow is currently in active API stabilization. The core runtime and major application systems are implemented and tested, but public APIs may still receive carefully considered changes before the stable 1.0 release.

Documentation, migration notes and compatibility information are included with the package.