--- id: quick-example title: Quick example sidebar_label: Quick example --- ## Create a state store Let's dive right in and define and export our first **state store**, by passing an initial state to `new Store()`: ```jsx import { Store } from "pullstate"; export const UIStore = new Store({ isDarkMode: true, }); ``` ```tsx import { Store } from "pullstate"; interface IUIStore { isDarkMode: boolean; } export const UIStore = new Store({ isDarkMode: true, }); ``` ## Read our store's state Then, in React, we can start using the state of that store using a simple hook `useState()` on the store iteself: ```tsx import * as React from "react"; import { UIStore } from "./UIStore"; export const App = () => { const isDarkMode = UIStore.useState(s => s.isDarkMode); return (

Hello Pullstate

); }; ``` The argument to `useState()` over here (`s => s.isDarkMode`), is a selection function that ensures we select only the state that we actually need for this component. This is a big performance booster, as we only listen for changes (and if changed, re-render the component) on the exact returned values - in this case, simply the value of `isDarkMode`. --- ## Add interaction (update state) Great, so we are able to pull our state from `UIStore` into our App. Now lets add some basic interaction with a ` ); ``` Notice how we call `update()` on `UIStore`, inside which we directly mutate the store's state. This is all thanks to the power of `immer`, which you can check out [here](https://github.com/immerjs/immer). Another pattern, which helps to illustrate this further, would be to actually define the action of toggling dark mode to a function on its own: ```tsx function toggleMode(s) { s.isDarkMode = !s.isDarkMode; } // ...in our ``` ```tsx function toggleMode(s: IUIStore) { s.isDarkMode = !s.isDarkMode; } // ...in our ``` Basically, to update our app's state all we need to do is create a function (inline arrow function or regular) which takes the current store's state and mutates it to whatever we'd like the next state to be. ## Omnipresent state updating Something interesting to notice at this point is that we are just importing `UIStore` directly and running `update()` on it: ```tsx import { UIStore } from "./UIStore"; // ...in our ``` And our components are being updated accordingly. We have freed our app's state from the confines of the component! This is one of the main advantages of Pullstate - allowing us to separate our state concerns from being locked in at the component level and manage things easily at a more global level from which our components listen and react (through our `useState()` hooks).