LumaFlow documentation

Build your first screen, then understand the system.

A practical route from an empty Unity scene to a maintainable reactive interface. Every section tells you what to do, why it matters and where to continue.

Read in this order if you are new.

You do not need to study the complete API before building an application. Start with one working screen, then learn the contracts that prevent layout and lifecycle bugs.

Four ideas explain most of LumaFlow.

Widget

A description, not a native view

Widgets are immutable C# values. Rebuilding one does not automatically recreate its UI Toolkit element.

Element

The retained mounted instance

It owns lifecycle and reconciliation. Compatible updates reuse the same VisualElement.

State

A value with explicit dependants

Only mounted branches that read a state value rebuild when it changes.

Key

Identity across movement

Keys preserve logical identity when children are reordered, inserted or removed.