square/workflow
Workflow
Workflow is a cross-platform architectural framework for building deterministic unidirectional state machines and user interfaces in native mobile applications. Available as libraries for both Kotlin and Swift, the framework manages application state and screen navigation using composable state machines that direct data in a single direction from source to interface while routing user actions back to business logic.
The architecture models screen navigation as nested presenter states and recursive component hierarchies rather than separate routing logic. Complex application features are built through the hierarchical composition of smaller workflows, utilizing immutable value types and pure state transition functions to process screen states, inputs, and navigation structures.
The system connects declarative rendering structures and event callback handlers directly to platform-specific mobile user interface elements. Business logic and state transitions are isolated into self-contained units that support unit testing without requiring mobile frameworks.
Features
- Widget Tree Compositions - Builds complex application features through recursive nesting of smaller state machines into modular component hierarchies.
- Unidirectional Data Flow - Directs application state and navigation downwards while routing user actions predictably back to business logic.
- Cross-Platform App Development - Provides a cross-platform architectural framework for building mobile applications across iOS and Android.
- Cross-Platform Mobile View Bindings - Connects declarative rendering structures and event callbacks directly to native mobile user interface frameworks for Android and iOS.
- Mobile Application State Management - Manages complex application state and data flow in mobile apps using predictable unidirectional patterns.
- Swift State Management Libraries - Provides a Swift library for building composable state machines and unidirectional user interface architectures.
- View Bindings - Connects declarative rendering structures and event callback handlers directly to platform-specific mobile user interface elements.
- Centralized State Containers - Routes data strictly from business logic to the interface and returns events in a single direction to keep application state unified.
- Kotlin Framework Libraries - Provides a Kotlin library for managing unidirectional application state and screen navigation using composable state machines.
- Cross-Platform Mobile Architectures - Implements an architectural pattern for driving native mobile user interfaces from deterministic state machines across multiple platforms.
- Business Logic Testing - Verifies application state machine correctness and validates business logic using straightforward unit tests that ensure reliable runtime behavior.
- Navigation State Management - Treats screen navigation as presenter state to manage complex flows using state machines.
- Immutable State Stores - Organizes business logic and screen state into immutable unidirectional units that pass data downward and trigger events upward.
- Hierarchical State Composition - Builds complex features through recursive composition of smaller workflows to scale state management and organize screens modularly.
- Value Type State Models - Represents all screen states, inputs, and navigation structures as immutable data values processed by pure state transition functions.
- Coordinator Navigation Patterns - Models navigation structures using nested presenter states and recursive component hierarchies.
- Business Logic Isolation - Isolates core business logic and state transitions into self-contained units that run simple unit tests without mobile frameworks.
- Component-Based State Management - Manages private state and configuration inputs to transform raw data into renderable display structures containing event handlers.
