MobX is the new, upcoming state management solution. This blog is all about how to create a simple React-Native app using MobX.

MobX is faster than Redux, easier to learn, and requires less boilerplate code.

Main Concepts

Stores

Stores create data sources. A store is basically an ES6 class. The state is automatically derived from a data source by MobX by using ES6 decorators.

1. The store can expose the observable field(s), to which an observer can react.
2. The store can additionally expose some derived observable fields too. Which are pure functions on observable fields? MobX calls them as computed fields.
3. The store can also change the values of observable fields via actions. Only in this way MobX can allow you to change state.

You may also like: How to Structure Your MobX App for the Real World.

Observables

Observables extend functionality to subscribe to their changes. We can list down our class properties with the @observable decorator, and, using observers, check their values.

These observers will be updated accordingly every time the values will change.

Computed Values

Computed values are derived from observables. These values will be automatically updated when the observables will change.

It should be kept in mind that, ‘computed’ has to be observed in order to be updated

Reactions

Reactions are identical to computed values, but they are used to produce side-effects instead of returning new value (patching DOM, making network requests, etc.).

MobX provides three reaction functions when, autorun, and reaction.

When — when takes two functions: predicate and effect. It executes and checks predicate until it returns true; it then executes the effect function. After that, it disposes and stops reacting to the checked property.

Autorun — autorun is used in specific cases where you want a reactive function that will get fired every time the checked value is updated. Unlike computed it doesn’t have to be checked itself.

Reaction — reaction is like autorun but gives you more control over what properties to check. It takes two functions,  data-function and side-effect-function. The data-function is observed and returns data that is used in side-effect-function.

Actions

Actions are responsible for altering the state.we can use them to explicitly mark that function with @action decorator.

This decorator takes a function and wraps it into a transaction, untracked and allows state changes.

Transaction — The transaction is used to batch together updates in the state, so until and unless that function is completed, no observers will be notified. So, we can update various properties at once.

Untracked — With the help of untracked, we can run code without establishing observers (just like reactions, or unlike computed’s)

Allow State Changes — Allow state changes is used to allow or reject state changes for certain functions. By default allows an action to make changes (and disallows them for computed and observer).

Observers

Honestly,  observers aren’t part of MobX core. They are provided by the mobx-react package. They are used to enable views to “observe” observables and re-render on change.

Let’s explore a simple ValueStore. It provides an observable field named count value and actions increase_value and decrease_value to change the value.

// @ flow

import {observable,action} from “mobx”;

class ValueStore{

     @observable countValue=0;

     @action increase_value()={

         this.countValue+=1;

       }

     @action decrease_value()={

         this.countValue-=1;

       }

}

export default ValueStore;

Here is a look at a component that keeps track of count value and re-renders every time the count value gets changed.

xxxxxxxxxx

// RN imports

import { observer, inject } from "mobx-react";

@inject("valueStore")

@observer

class Counter extends Component {

  render() {

      return <Text>Count:  {this.props.valueStore.count}</Text>;

  }

}

By decorating class with  @observer, MobX can infer reactions to the changes in store and automatically subscribe to them and re-render component on getting changes.

@inject is a MobX decorator that will provide component props with the mentioned store.

MobX provides a React Provider that can be made as a parent component for all the components of your application. A MobX provider should be initialized with all the stores that you may want to be injected into your components.

xxxxxxxxxx

import { Provider } from "mobx-react";

class App extends Component {

  render() {

     return (

      <Provider {counterStore: new ValueStore(), userStore:      new UserStore()}>

            <Home />

      </Provider>

    );

 }

}

export default App;

Now, all children of the Home component can be injected with value stores and user stores.

Further Reading

• Everything React: Tutorials for Beginners and Experts Alike.
• Introduction to Redux.
• Learn the Basics of Redux for React.