---
id: third-party-mobx
title: MobX
sidebar_label: MobX
---

## MobX
MobX is one of the most popular state management libraries used by applications sized from small to large. 
With the introduction of the new React Context API, MobX can now be very easily integrated in React Native Navigation
projects.

In the example we will be creating a small Counter app.

:::info Note
With the introduction of the new Context API, there is no need to use `Provider` pattern with MobX and you
can now just use the React Context API.

Also the example uses `mobx-react-lite` but you can use the normal `mobx-react`.
:::

## Create a Counter store.
Let's first create a counter store using MobX.

```tsx
// counter.store.js
import React from 'react'
import { observable, action } from 'mobx'

class CounterStore {
  @observable count = 0

  @action.bound
  increment() {
    this.count += 1
  }

  @action.bound
  decrement() {
    this.count -= 1
  }
}

// Instantiate the counter store.
const counterStore = new CounterStore()
// Create a React Context with the counter store instance.
export const CounterStoreContext = React.createContext(counterStore)
```

## Consuming the store
You can consume the Counter store in any React components using `React.useContext`.

```tsx
// Counter.js
import React from 'react'
import { Button, Text, View } from 'react-native'
import { observer } from 'mobx-react-lite'
import { CounterStoreContext } from './counter.store'

const CounterScreen = observer(() => {
  const { count, increment, decrement } = React.useContext(CounterStoreContext)

  return (
    <View>
      <Text>{`Clicked ${count} times!`}</Text>
      <Button title="Increment" onPress={increment} />
      <Button title="Decrement" onPress={decrement} />
    </View>
  )
})
```

## How to use MobX persistent data
Often the app will require a persistent data solution and with MobX you can use [`mobx-react-persist`](https://github.com/pinqy520/mobx-persist).
It only takes few extra steps to integrate the library.

```tsx
//counter.store.js
import React from 'react'
import { observable, action } from 'mobx'
import { persist } from 'mobx-persist' // add this.

class CounterStore {
  @persist @observable count = 0 // count is now persistent.

  @action.bound
  increment() {
    this.count += 1
  }

  @action.bound
  decrement() {
    this.count -= 1
  }
}

export const counterStore = new CounterStore() // You need to export the counterStore instance.
export const CounterStoreContext = React.createContext(counterStore)

// index.js
import { Navigation } from 'react-native-navigation
import AsyncStorage from '@react-native-community/async-storage'
import { create } from 'mobx-persist'
import { counterStore } from './counter.store // import the counter store instance.

// Create a store hydration function.
async function hydrateStores() {
  const hydrate = create({ storage: AsyncStorage })

  await hydrate('CounterStore', counterStore)
}

Navigation.events().registerAppLaunchedListener(() => {
  hydrateStores().then(() => {
    // ...register screens and start the app.
  })
})
```