@lacspace/store

Global state in ~1 KB

v1.0.0React Kit — hooks, state, data & UX zero deps · react 18+TypeScript

On this page

When to use it
Overview
Install
Quick example
Key API
Tips
Watch out for
More in React Kit — hooks, state, data & UX

When to use it

Sharing state across components without prop-drilling or a Context provider — and when Redux/MobX feel like too much. Also great for state you need to read or write from outside React.

Overview

Create a store, use selectors, no provider — built on useSyncExternalStore with a persist middleware and shallow equality. A Zustand-lite that also works outside React.

Install

$ npm install @lacspace/store

Quick example

@lacspace/storets

const useStore = create((set) => ({ n: 0 }))

Key API

create(initializer)Returns a `useStore` hook + attached getState/setState/subscribe.

createStore(initializer)The vanilla, framework-agnostic store (no React).

useStore(selector?, equalityFn?)Subscribe to the whole state or a selected slice.

persist(initializer, options)localStorage/sessionStorage middleware with partialize + version.

shallow(a, b)One-level equality for multi-value selectors.

Tips

`create((set, get) => ({ ... }))` returns a hook that is ALSO the store API — call `useStore.getState()` / `useStore.setState()` / `useStore.subscribe()` anywhere, even outside components.

Pass a selector to subscribe to just one slice: `useStore((s) => s.count)` — the component re-renders only when that slice changes.

Selecting multiple values? Return an object and pass `shallow` as the equality fn to avoid needless re-renders: `useStore((s) => ({ a: s.a, b: s.b }), shallow)`.

Wrap the initializer in `persist(fn, { name })` to save to localStorage; use `partialize` to persist only part of the state.

Watch out for

`setState` shallow-merges by default — pass `replace: true` to swap the whole state object.

`persist` reads storage on creation (SSR-safe); the first server render uses initial state, so guard against layout shift if persisted values change what renders.

Looking for the complete API and more examples? The npm page and GitHub README carry the full reference — or grab the PDF.

Lacspace

@lacspace/store

Global state in ~1 KB

v1.0.0React Kit — hooks, state, data & UX zero deps · react 18+TypeScript

Download PDF npm Source

On this page

When to use it
Overview
Install
Quick example
Key API
Tips
Watch out for
More in React Kit — hooks, state, data & UX

When to use it

Sharing state across components without prop-drilling or a Context provider — and when Redux/MobX feel like too much. Also great for state you need to read or write from outside React.

Overview

Create a store, use selectors, no provider — built on useSyncExternalStore with a persist middleware and shallow equality. A Zustand-lite that also works outside React.

Install

$ npm install @lacspace/store

Quick example

@lacspace/storets

const useStore = create((set) => ({ n: 0 }))

Key API

create(initializer)Returns a `useStore` hook + attached getState/setState/subscribe.

createStore(initializer)The vanilla, framework-agnostic store (no React).

useStore(selector?, equalityFn?)Subscribe to the whole state or a selected slice.

persist(initializer, options)localStorage/sessionStorage middleware with partialize + version.

shallow(a, b)One-level equality for multi-value selectors.

Tips

`create((set, get) => ({ ... }))` returns a hook that is ALSO the store API — call `useStore.getState()` / `useStore.setState()` / `useStore.subscribe()` anywhere, even outside components.

Pass a selector to subscribe to just one slice: `useStore((s) => s.count)` — the component re-renders only when that slice changes.

Selecting multiple values? Return an object and pass `shallow` as the equality fn to avoid needless re-renders: `useStore((s) => ({ a: s.a, b: s.b }), shallow)`.

Wrap the initializer in `persist(fn, { name })` to save to localStorage; use `partialize` to persist only part of the state.

Watch out for

`setState` shallow-merges by default — pass `replace: true` to swap the whole state object.

`persist` reads storage on creation (SSR-safe); the first server render uses initial state, so guard against layout shift if persisted values change what renders.

Looking for the complete API and more examples? The npm page and GitHub README carry the full reference — or grab the PDF.

When to use it

Overview

Install

Quick example

Key API

Tips

Watch out for

More in React Kit — hooks, state, data & UX

When to use it

Overview

Install

Quick example

Key API

Tips

Watch out for

More in React Kit — hooks, state, data & UX