Changelog

What changed in each version.

1.4.0 · 24 October 2026

The package's .meta files no longer change GUIDs. An Editor upgrade had regenerated them, which would have disconnected every StateFlow Manager, StateFlow Asset and State Asset in projects updating from 1.3.x, and broke the graph window's styles.
With Addressables loading, a trigger raised while a state was still loading (from a global trigger, a toast or spawned content) acted on a half-updated stack and could leave two states on screen. Triggers raised during a load now wait and run in order once the loading state is shown.
With Addressables loading, a state whose State Asset sits in a Resources folder failed to load, because Addressables 2 no longer resolves Resources paths. Keys that are not Addressable now load from Resources, as the StateFlow Asset inspector already promised.
A state that failed to load no longer takes the current state with it: the current state stays on screen and its triggers keep working. Going down to a lower layer that has no state yet now keeps every open state until the new one loads, and when the replacement for a lower layer's state fails to load, that state takes control again.
Entering play mode with domain reload disabled no longer keeps registrations from the previous session.
Closing the StateFlow Editor window releases its graph, and Find state and Follow no longer stop a pixel short of the state on high-DPI screens and keep the view animating.

A state covered by a popup that raises a connected trigger logs a warning naming the state and trigger, since StateFlow ignores it.

IAssetLoadContext and IAssetProviderStrategy return IPromise<IStateAsset> instead of Task<IStateAsset>.
StateManager takes its collaborators in its constructor; create one with StateManagerFactory.Create.
The DLLs are now Release builds, and the runtime DLL is no longer compiled with UNITY_EDITOR defined.

Enter and Exit now always alternate. A state that opened a popup or was replaced from its own Initialize or LateInitialize used to get Exit before it had entered, then Enter anyway, then a second Enter when the popup closed. Anything it subscribed in Enter was left subscribed after the state was destroyed. Now a covered state enters when the state above it closes, and a replaced one never enters.

Build check: before a player build, every StateFlow Asset is checked for states the player would fail to load, and each problem is reported in the Console.
The StateFlow Asset inspector lists states that will not load with the selected load type and fixes them in one click.
Feature Samples in Assets/StateFlow/Samples: nine scenes covering each core feature.

With Addressables loading, prefab states are found by asset GUID, so moving or renaming a State Asset no longer breaks the graph.
ManagedLifecycle is renamed to StateFlowSpawner, with Spawn and Despawn replacing Instantiate and Dispose.

ManagedLifecycle still works and forwards to StateFlowSpawner, but shows an obsolete warning. It will be removed in 2.0.

First public release.

Visual graph editor for UI flows, with screens, popups, dialogs and alerts on four ordered layers.
Type-safe triggers: Trigger, Trigger<T> and Trigger<T1, T2> events become output ports.
Payloads delivered to the next state through IStateFlowComponentWithPayload<T>.
Scripted transitions per connection, with underlay and overlay layers.
State lifecycle: Initialize, SetPayload, LateInitialize, Enter, TransitionFinished, Exit, Dispose.
Script states, sub-state machines with entry and exit states, and linked machines.
Toasts with built-in or custom animations, and global triggers raised from anywhere.
Spawned content through [SpawnedState] and ManagedLifecycle.
State observer, Resources or Addressables loading, and a live play-mode view.
Groups, sticky notes, minimap, search, follow mode, grid snapping, alignment and a colour legend.