node package manager
Easy sharing. Manage teams and permissions with one click. Create a free org »


choo-model stability

npm version build status test coverage downloads js-standard-style

State management lib for choo ✌️. Experiment for now. Might become part of choo at some point, who knows.


const Model = require('choo-model')
const mount = require('choo/mount')
const html = require('choo/html')
const choo = require('choo')
const app = choo()
app.router(['/', mainView ])
mount('body', app.start())
function todosModel () {
  const model = Model('todos')
  model.state({ todos: [] })
  model.reducer('add', (state, data) => state.push({ text: data }))
  return model.start()
function mainView (state, prev, send) {
  return html`
      <main><p>Todos: ${state.todos}</p></main>


model = Model(namespace?)

Create a new model instance


Return the model object, ready for the app.model() call.

model.reducer(name, reducer)

Create a new reducer


Save new state. The resulting state is combined into a single state object under the hood.

model.subscription(name, subscription)

Create a new subscription

model.effect(name, effect)

Create a new effect

model.effect(name, effect)

Create a new effect


$ npm install choo-model



Because experimenting outside of core is the right way to do things.

What can we expect to land in here?

Probably the ability to set constraints on send() calls so they can't access everything. Also the ability to create graph data based on those constraints. Perhaps selectors too. Y'know, basic stuff.

Why aren't you doing X first?

Having a solid story for state management is quite important. Some abstractions start to break down once apps grow; we're hitting that point. Everything else is irrelevant if we can't scale and use it ourselves on real projects.

How can I contribute?

Try it out. Build things on top of it. Build out alternatives.

Is this optimizable?

Yeah, definitely - if this ever makes the cut we can statically analyze the code and precompile the result so it'll have no overhead at runtime. Yay!