• Stars
    star
    2,865
  • Rank 15,771 (Top 0.4 %)
  • Language
    JavaScript
  • Created almost 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🌶 350b / 650b state container with component actions for Preact & React

unistore
npm travis

unistore

A tiny 350b centralized state container with component bindings for Preact & React.

  • Small footprint complements Preact nicely (unistore + unistore/preact is ~650b)
  • Familiar names and ideas from Redux-like libraries
  • Useful data selectors to extract properties from state
  • Portable actions can be moved into a common place and imported
  • Functional actions are just reducers
  • NEW: seamlessly run Unistore in a worker via Stockroom

Table of Contents

Install

This project uses node and npm. Go check them out if you don't have them locally installed.

npm install --save unistore

Then with a module bundler like webpack or rollup, use as you would anything else:

// The store:
import createStore from 'unistore'

// Preact integration
import { Provider, connect } from 'unistore/preact'

// React integration
import { Provider, connect } from 'unistore/react'

Alternatively, you can import the "full" build for each, which includes both createStore and the integration for your library of choice:

import { createStore, Provider, connect } from 'unistore/full/preact'

The UMD build is also available on unpkg:

<!-- just unistore(): -->
<script src="https://unpkg.com/unistore/dist/unistore.umd.js"></script>
<!-- for preact -->
<script src="https://unpkg.com/unistore/full/preact.umd.js"></script>
<!-- for react -->
<script src="https://unpkg.com/unistore/full/react.umd.js"></script>

You can find the library on window.unistore.

Usage

import createStore from 'unistore'
import { Provider, connect } from 'unistore/preact'

let store = createStore({ count: 0, stuff: [] })

let actions = {
  // Actions can just return a state update:
  increment(state) {
    // The returned object will be merged into the current state
    return { count: state.count+1 }
  },

  // The above example as an Arrow Function:
  increment2: ({ count }) => ({ count: count+1 }),

  // Actions receive current state as first parameter and any other params next
  // See the "Increment by 10"-button below
  incrementBy: ({ count }, incrementAmount) => {
    return { count: count+incrementAmount }
  },
}

// If actions is a function, it gets passed the store:
let actionFunctions = store => ({
  // Async actions can be pure async/promise functions:
  async getStuff(state) {
    const res = await fetch('/foo.json')
    return { stuff: await res.json() }
  },

  // ... or just actions that call store.setState() later:
  clearOutStuff(state) {
    setTimeout(() => {
      store.setState({ stuff: [] }) // clear 'stuff' after 1 second
    }, 1000)
  }

  // Remember that the state passed to the action function could be stale after
  // doing async work, so use getState() instead:
  async incrementAfterStuff(state) {
    const res = await fetch('foo.json')
    const resJson = await res.json()
    // the variable 'state' above could now be old,
    // better get a new one from the store
    const upToDateState = store.getState()

    return {
      stuff: resJson,
      count: upToDateState.count + resJson.length,
    }
  }
})

// Connecting a react/preact component to get current state and to bind actions
const App1 = connect('count', actions)(
  ({ count, increment, incrementBy }) => (
    <div>
      <p>Count: {count}</p>
      <button onClick={increment}>Increment</button>
      <button onClick={() => incrementBy(10)}>Increment by 10</button>
    </div>
  )
)

// First argument to connect can also be a string, array or function while
// second argument can be an object or a function. Here we pass an array and
// a function.
const App2 = connect(['count', 'stuff'], actionFunctions)(
  ({ count, stuff, getStuff, clearOutStuff, incrementAfterStuff }) => (
    <div>
      <p>Count: {count}</p>
      <p>Stuff:
        <ul>{stuff.map(s => (
         <li>{s.name}</li>
        ))}</ul>
      </p>
      <button onClick={getStuff}>Get some stuff!</button>
      <button onClick={clearOutStuff}>Remove all stuff!</button>
      <button onClick={incrementAfterStuff}>Get and count stuff!</button>
    </div>
  )
)

export const getApp1 = () => (
  <Provider store={store}>
    <App1 />
  </Provider>
)

export const getApp2 = () => (
  <Provider store={store}>
    <App2 />
  </Provider>
)

Debug

Make sure to have Redux devtools extension previously installed.

import createStore from 'unistore'
import devtools    from 'unistore/devtools'

let initialState = { count: 0 };
let store = process.env.NODE_ENV === 'production' ?  createStore(initialState) : devtools(createStore(initialState));

// ...

Examples

README Example on CodeSandbox

API

createStore

Creates a new store, which is a tiny evented state container.

Parameters

  • state Object Optional initial state (optional, default {})

Examples

let store = createStore();
store.subscribe( state => console.log(state) );
store.setState({ a: 'b' });   // logs { a: 'b' }
store.setState({ c: 'd' });   // logs { a: 'b', c: 'd' }

Returns store

store

An observable state container, returned from createStore

action

Create a bound copy of the given action function. The bound returned function invokes action() and persists the result back to the store. If the return value of action is a Promise, the resolved value will be used as state.

Parameters

  • action Function An action of the form action(state, ...args) -> stateUpdate

Returns Function boundAction()

setState

Apply a partial state object to the current state, invoking registered listeners.

Parameters

  • update Object An object with properties to be merged into state
  • overwrite Boolean If true, update will replace state instead of being merged into it (optional, default false)
subscribe

Register a listener function to be called whenever state is changed. Returns an unsubscribe() function.

Parameters

  • listener Function A function to call when state changes. Gets passed the new state.

Returns Function unsubscribe()

unsubscribe

Remove a previously-registered listener function.

Parameters

  • listener Function The callback previously passed to subscribe() that should be removed.
getState

Retrieve the current state object.

Returns Object state

connect

Wire a component up to the store. Passes state as props, re-renders on change.

Parameters

  • mapStateToProps (Function | Array | String) A function mapping of store state to prop values, or an array/CSV of properties to map.
  • actions (Function | Object)? Action functions (pure state mappings), or a factory returning them. Every action function gets current state as the first parameter and any other params next

Examples

const Foo = connect('foo,bar')( ({ foo, bar }) => <div /> )
const actions = { someAction }
const Foo = connect('foo,bar', actions)( ({ foo, bar, someAction }) => <div /> )

Returns Component ConnectedComponent

Provider

Extends Component

Provider exposes a store (passed as props.store) into context.

Generally, an entire application is wrapped in a single <Provider> at the root.

Parameters

  • props Object
    • props.store Store A {Store} instance to expose via context.

Reporting Issues

Found a problem? Want a new feature? First of all, see if your issue or idea has already been reported. If not, just open a new clear and descriptive issue.

License

MIT License © Jason Miller

More Repositories

1

mitt

🥊 Tiny 200 byte functional event emitter / pubsub.
TypeScript
9,030
star
2

htm

Hyperscript Tagged Markup: JSX alternative using standard tagged templates, with compiler support.
JavaScript
8,661
star
3

microbundle

📦 Zero-configuration bundler for tiny modules.
JavaScript
8,047
star
4

unfetch

🐕 Bare minimum 500b fetch polyfill.
JavaScript
5,637
star
5

greenlet

🦎 Move an async function into its own thread.
JavaScript
4,621
star
6

workerize

🏗️ Run a module in a Web Worker.
JavaScript
4,287
star
7

redaxios

The Axios API, as an 800 byte Fetch wrapper.
JavaScript
4,131
star
8

express-es6-rest-api

🔋 Starter project for an ES6 RESTful Express API.
JavaScript
2,460
star
9

workerize-loader

🏗️ Automatically move a module into a Web Worker (Webpack loader)
JavaScript
2,283
star
10

snarkdown

😼 A snarky 1kb Markdown parser written in JavaScript
JavaScript
2,180
star
11

stockroom

🗃 Offload your store management to a worker easily.
JavaScript
1,758
star
12

dlv

Safe deep property access in 120 bytes. x = dlv(obj, 'a.b.x')
JavaScript
1,217
star
13

karmatic

🦑 Easy automatic (headless) browser testing with Jest's API, but powered by Karma & Webpack.
JavaScript
1,181
star
14

decko

💨 The 3 most useful ES7 decorators: bind, debounce and memoize
JavaScript
1,038
star
15

preact-boilerplate

🎸 Ready-to-rock Preact starter project, powered by Webpack.
JavaScript
976
star
16

web-worker

Consistent Web Workers in browser and Node.
JavaScript
949
star
17

vhtml

Render JSX/Hyperscript to HTML strings, without VDOM 🌈
JavaScript
740
star
18

histore

🏬 200b key-value store backed by navigation state
JavaScript
677
star
19

optimize-plugin

Optimized Webpack Bundling for Everyone. Intro ⤵️
JavaScript
658
star
20

undom

🍩 1kb minimally viable DOM Document implementation
JavaScript
654
star
21

asyncro

⛵️ Beautiful Array utilities for ESnext async/await ~
JavaScript
493
star
22

nextjs-preact-demo

Next.js 9.3 + Preact = 21kB
JavaScript
384
star
23

tags-input

🔖 <input type="tags"> like magic
JavaScript
328
star
24

linkstate

Bind events to state. Works with Preact and React.
JavaScript
296
star
25

preact-redux

➿ Preact integration for Redux (no shim needed!)
JavaScript
288
star
26

task-worklet

Task Worklet: explainer, polyfill and demos.
JavaScript
275
star
27

jsdom-worker

👷‍♀️ Use Web Workers in Jest / JSDOM 🌈
JavaScript
273
star
28

preact-worker-demo

Demo of preact rendering an entire app in a Web Worker.
JavaScript
217
star
29

preact-virtual-list

📇 Virtual List that only renders visible items. Supports millions of rows.
JavaScript
215
star
30

jsxobj

Build JSON using JSX 🌈 (may contain blood magic)
JavaScript
214
star
31

preact-redux-example

🔁 Preact + Redux Example Project
JavaScript
201
star
32

preact-markup

⚡ Render HTML5 as VDOM, with Components as Custom Elements!
JavaScript
195
star
33

simple-element-resize-detector

Observes element size changes using a hidden iframe
JavaScript
190
star
34

preact-mdl

💥 A collection of Preact Components that encapsulate Google's Material Design Lite.
JavaScript
186
star
35

zero-to-preact

A Step-by-step Guide to Preact + Webpack 2, without boilerplate!
JavaScript
179
star
36

state-machine-component

⚙️ State machine -powered components in 250 bytes
JavaScript
177
star
37

preact-portal

📡 Render Preact components in (a) SPACE 🌌 🌠
JavaScript
176
star
38

preact-photon

🚀 Beautiful desktop apps with Preact + Photon ❤️
JavaScript
173
star
39

preact-slots

🕳 Render Preact trees into other Preact trees, like portals.
JavaScript
157
star
40

oss.ninja

👩‍⚖️ Dynamic licenses for your projects - no more LICENSE.txt!
JavaScript
146
star
41

preact-cycle

♻️ Minimal functional Virtual DOM rendering using Preact 🚲
JavaScript
131
star
42

dropfox

🦊 📂 A dropbox client powered by Preact, Electron and Photon
JavaScript
122
star
43

preact-scroll-viewport

Preact Component that renders homogeneous children only when visible
JavaScript
121
star
44

babel-preset-modernize

JavaScript
121
star
45

resource-router-middleware

🚴 Express REST resources as middleware mountable anywhere
JavaScript
120
star
46

object-diff-patch

JavaScript
103
star
47

preact-todomvc

💣 TodoMVC done in Preact. Under 6kb and fast.
JavaScript
102
star
48

restful-mongoose

🐦 Expose Mongoose models as RESTful Express resources.
JavaScript
90
star
49

modify-babel-preset

💫 Create a modified babel preset based on an an existing preset.
JavaScript
85
star
50

preact-without-babel

🐎 How to use Preact in (native) ES2015, without Babel or JSX.
JavaScript
79
star
51

preact-shadow-root

🕴 Render a Preact subtree into the Shadow DOM.
JavaScript
72
star
52

linkref

Like Linked State, but for Refs. Works with Preact and React.
JavaScript
61
star
53

preact-css-transition-group

Apply CSS transitions when adding or removing Preact components/elements
JavaScript
61
star
54

proptypes

💂‍♂️ React's PropTypes, as a standalone module.
JavaScript
59
star
55

preact-token-input

🔖 A text field that tokenizes input, for things like tags.
JavaScript
59
star
56

nectarine

🍑 A mobile web / Android app for Peach! (peach.cool) ⚡
JavaScript
59
star
57

unified-element-properties-proposal

Unified Element Properties for the DOM
58
star
58

preact-jsx-chai

✅ Add JSX assertions to Chai, with support for Preact Components.
JavaScript
56
star
59

preact-compat-example

🚤 Demo of preact-compat + react-toolbox to reduce build size by 95%.
JavaScript
52
star
60

preact-transition-group

transition-group ui component for preact
JavaScript
51
star
61

scroll-list

📜 An infinitely scrollable list/datagrid. Handles millions of rows.
JavaScript
48
star
62

preact-in-es3

🐴 How to use Preact without Babel, ES2015 or JSX.
JavaScript
46
star
63

rollup-plugin-preserve-shebang

Rollup plugin to automatically preserve shebangs in entry modules.
JavaScript
45
star
64

preact-cli-plugin-async

Preact CLI plugin that adds converts async/await to Promises.
JavaScript
44
star
65

preact-views

📺 Named views for Preact, with easy-as-pie linking between them.
JavaScript
39
star
66

preact-richtextarea

📰 A text field that supports HTML editing. 📝
JavaScript
39
star
67

react-router-4-test

Did you know you can use React Router with Preact, no -compat?
JavaScript
35
star
68

element-worklet

34
star
69

documentation-viewer

📜 Hosted viewer for documentation.js JSON output.
JavaScript
34
star
70

sleeper

😴 REST abstraction so easy you could use it with your eyes closed. 💤
JavaScript
30
star
71

neatime

Returns a simple relative time string.
JavaScript
30
star
72

babel-preset-preact

Babel preset to transform JSX into h() calls
JavaScript
30
star
73

ama

Ask me stuff
28
star
74

htmlParser

Simple JavaScript HTML parser.
JavaScript
27
star
75

precharts

Just Recharts pre-aliased for Preact.
JavaScript
27
star
76

object-shape

Get a description of a JS object's shape.
JavaScript
24
star
77

eslint-config-developit

developit's generic eslint config for libraries
JavaScript
21
star
78

peach.cool

🍑 JavaScript library for Peach (peach.cool) ⚡
JavaScript
21
star
79

progress-spinner

⌚ A simple, CSS-only indeterminate spinner custom element.
HTML
21
star
80

rollup-plugin-postprocess

🎞 Find & replace postprocessing for Rollup output
JavaScript
18
star
81

desky

18
star
82

jasonformat.com

My blog
JavaScript
18
star
83

preact-tap-event-plugin

☝️ onTouchTap for preact
JavaScript
17
star
84

preact-svg

[DEPRECATED] 🎨 Use inline <svg> in Preact 4 and prior. 🌷
JavaScript
16
star
85

preact-styled-jsx-demo

Preact + styled-jsx = 💞
JavaScript
16
star
86

preact-vite-template

JavaScript
15
star
87

espz

JavaScript
13
star
88

microbundle-2

JavaScript
13
star
89

hazelnut

🌰 Tiny inline AMD registry.
JavaScript
12
star
90

puredom

💲 Fast, chainable and exstensible JavaScript library for building web applications.
JavaScript
11
star
91

request-easy-cache

🐎 A simple, configurable & instantiable caching wrapper around request.
JavaScript
11
star
92

templeton

💪 Templating like the other ones, but not at all like the other ones.
JavaScript
10
star
93

bamboo-status-svg

A web service that generates build badges for Bamboo plans.
JavaScript
9
star
94

ford.js

👔 The library nobody wants but that is for some reason still mayor.
JavaScript
8
star
95

jasonp

An itty bitty JSONP module
JavaScript
7
star
96

browser-nativefs

Native File System API with legacy fallback in the browser
JavaScript
7
star
97

strip-dom-whitespace

Traverses the DOM to strip whitespace-only Text nodes
JavaScript
6
star
98

picomarkdown

Converts basic markdown to HTML.
JavaScript
6
star
99

babel-preset-es2015-minimal

💄 Babel's es2015 preset in loose mode without frills.
JavaScript
5
star
100

esbench

ESBench Feedback (future public repo)
4
star