State

The application state is defined in a single data structure which should be a struct. This struct can have other structs as members, that allows you to add different sub-states as your app grows.

The state struct should store your entire application state, that includes the UI state, the navigation state and the state of your model layer.

Here’s an example of a state struct as defined in the Counter Example:

struct AppState: StateType, HasNavigationState {
    var counter: Int = 0
    var navigationState = NavigationState()
}

There are multiple things to note:

  1. Your app state struct needs to conform to the StateType protocol, currently this is just a marker protocol, but we will likely add requirements (such as the ability to serialize the state) before v1.0.
  2. If you are including SwiftRouter in your project, your app state needs to conform to the HasNavigationState protocol. This means you need to add a property called navigationState to your state struct. This is the sub-state the router will use to store the current route.