README

react-tangle

A simple react app state management library.

Motivation

Use it to make it quickly provide shared state for your React projects and ideal for rapid application prototyping. Reduces most boilerplates and just share state between components directly.

Example

TodoMvC

Basic

  npm install react-tangle

Then you need to render your app enclosed in a TangleProvider.


return (
  <TangleProvider initialValue={{}}>
    <App/>
  </TangleProvider>
)

To use a shared state between 2 components, use the useTangledState hook

  import { useTangledState } from 'react-tangle'

  // here App
  const TodosList = () => {
    const [todos] = useTangledState('todos', [])

    return (
      <div>
        { todos.map(todo => (<div key={todo}>{todo}</div>))}
      </div>
    )
  }

  const AddTodo = () => {
    const [todos, setTodos] = useTangledState('todos', [])

    const onAdd = (todo: string) => {
      setTodos((current) => {
        return current.concat([todo]) // todos under TodosList should update
      })
    }
    return (
      <div>
        <AddTodoComponent onAdd={onAdd}/>
      </div>
    )
  }

License

MIT

Others

Thanks to @tmcw for providing the react-tangle npm package

Usage no npm install needed!