Skip to content

restatejs is new global state management library for react which focus on simplicity and productivity.restatejs is context-less so you don't need to wrap your react app in Provider or Context.

Notifications You must be signed in to change notification settings

hodev-dev/restatejs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

restatejs

restatejs is new global state management library for react which focus on simplicity and productivity.restatejs is context-less so you don't need to wrap your react app in Provider or Context.

  • restatejs is context-less
  • restatejs is controller for manage code
  • restatejs supports persist state
  • restate js supports async (like redux-thunk) and *generators (like redux-saga)
  • restatejs uses default react useState() hook under the hood so no need other debuging extentions

install

npm install  @hodev/restatejs

Or

yarn add @hodev/restatejs

How To Use:

  • create controllers folder
  • make controller
  • create group
  • add multi controller to the group
  • export group

make controller

import { Group, IBasicController, IController, IGroup } from '@hodev/restatejs';

const counterController: IBasicController = {
  name: 'counterController',
  default: 0,
  methods: {
    inc: (controller: IController, group: IGroup, input: any, state: any) => {
      controller.setState(state + 1);
    }
  }
}

const counterGroup: IGroup = new Group(localStorage);

counterGroup.add([counterController]);

export { counterGroup };

React Hoook

import group that you just created

import { counterGroup } from './controller/counterController';

import useController

import { useController } from '@hodev/restatejs';

pass group and name of the controller you wnat to connect

  const [state,status] = useController(counterGroup, 'counterController');

if gives you state and status of state of controller state has 3 state

  • LOADING : 0
  • SUCCESS:1
  • FAILED: 2
import {statusTypes} from '@hodev/restatejs'

then you can use then like this:

(status === statusTypes.LOADING) ? "do soemthing" : "do somethign else"

component will get connected like this

import { useController } from '@hodev/restatejs';
import React from 'react';
import { counterGroup } from './controller/counterController';

function App() {
  const [counter] = useController(counterGroup, 'counterController');
  return (
    <div className="App">
      <h1>{counter}</h1>
    </div>
  );
}

export default App;

Run Method

group has run() method but it has it's own way to run method. as you see firstly we pass string which contain name of the controller (here is counterController) and we put method name that we want to run after @

inc is function we decleared inside our controller

 counterGroup.run('counterController@inc', [], counter);
import { useController } from '@hodev/restatejs';
import React from 'react';
import { counterGroup } from './controller/counterController';

function App() {
  const [counter] = useController(counterGroup, 'counterController');

  const inc = () => {
    counterGroup.run('counterController@inc', [], counter);
  }
  return (
    <div className="App">
      <h1>{counter}</h1>
      <button onClick={inc}>increament</button>
    </div>
  );
}

export default App;

persist data

react native

  • async storage

web browser

  • localStorage

it should be passed to group constructor example: for web

const counterGroup: IGroup = new Group(localStorage);

or for react native

const counterGroup: IGroup = new Group(AsyncStorage);

then

to persist data just add persist key to your controller then restatejs does the job

{
   name: 'counterController',
  "default": 0,
  persist: true, <= here
  methods: {
    inc: (controller: IController, group: IGroup, input: any, state: any) => {
      controller.setState(state + 1);
    }
  }
}

typescirpt

const {IBasicController, IController, IGroup} from '@hodev/restatejs'

typescript is fully supported

About

restatejs is new global state management library for react which focus on simplicity and productivity.restatejs is context-less so you don't need to wrap your react app in Provider or Context.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published