Skip to content

App State

The Device Manager includes a state management service that serves as a centralized state store for all the components in the application.

The state service allows arbitrary data to be centrally stored and shared between app components. One or more State stores can be created for different state.

The primary advantages of using a centralized state store is the predictable ordering of state changes and the uncoupling of components that need to share state.

State Stores

The standard device manager provides the following state stores:

Name Description
app Manager state data regarding the app in general
config Configuration data from the ioto.json5 and other config files
auth User authentication data

Accessing State

import {State} from 'manager'

let darkMode =

Creating a State Store

To create a new state store, create a state class and use the Store.add to add the store to the centralized state service.

State stores are available as properties on the State object.

import {Store, State} from 'manager'
class MyState {
    temp = 0
    speed: 42
    increment() {
    get speed() { return this.speed }
    set speed(v) { this.speed = v }
    async stop() {
        await database.stop()
Store.add('my', new MyState())


Config State

The Config store holds general config state including:

Property Description
api Backend cloud service API
cognito Cognito config
build App build number
profile Execution profile (prod
name App name
title App display title
version App version (x.y.z)

Auth State

The Auth state store holds authentication state including:

Property Description
account Account object
accountName Account name
accountId Account ID
auth Authentication tokens
authenticated Boolean set to true when the user credentials are authenticated
authorized Boolean set to true when the user is fully logged in
email User's login email address
ready Set to true when the user is logged in and the app is ready to start
role User's authenticated role
user User object
username User login name
userId User ID


If you are building your own custom Device Manager, you can also use other state stores such as Pinia.