redis like key-value state management solution for React
Reactive. Redux alternative. Simple and powerful global state management system, accessible through every component.
Philosophy
jedisdb is a wrapper for React.JS useState hook. jedisdb makes the hook accessible in every component without the need to explicity pass it down or to create stores, actions, and dispatchers.
Features 📋
1. Reactive
2. State accessable through every components
3. no reducer, no action needed
4. small bundle size
Basic Usage
```
npm i jedisdb
or
yarn add jedisdb
```
happy hacking
```javascript
import React from 'react'
import useJedis from 'jedisdb'
const Counter = () =>{
/*
if a key is not present in jedis, useJedis('myKey', fallbackValue) will create create that key in jedisdb and then it will return that jedis object,
if key is present it will simply return that jedis object
if we don't pass fallbackValue it will create jedis object with value undefined
*/
const counter = useJedis('counter', 0)
return (
My counter
{counter.state}
);
}
```
Demo:
Counter [Codesandbox](https://codesandbox.io/s/usejedis-demo1-owozg?file=/src/App.js).
Shopping Cart [Codesandbox](https://codesandbox.io/s/shopping-cart-usejedis-qbgwq?file=/src/App.js).
>`useJedis` returns a react hook so it can only used in react functional components,
`selectState` has no side effects, it can be used anywhere,
`createState` creates jedis object without any side effects.
demo: Accessing value in JS funciton [Codesandbox](https://codesandbox.io/s/usejedis-demo2-pdfsm?file=/src/App.js).
Best Practice
use `createState` to create jedis object and then use `useJedis` to access it, is considered best practice
```javascript
//myGlobalHook.js
//create jedis object
import {createState} from 'jedisdb'
createState({
theme: 'dark',
uesrLevel: 'admin',
counter: 7
})
```
```javascript
//app.js
//import jedis object in app
import React from 'react';
import Main from './main';
require('./myGlobalHook')
function App() {
return (
);
}
export default App;
```
```javascript
//counter.js
//access anywhere
import React from 'react';
import useJedis from "jedisdb";
function Counter() {
const counter = useJedis('counter') //no need to pass fallback value
return (
<>
{counter.state}
);
}
export default Counter;
```
demo: [Codesandbox](https://codesandbox.io/s/usejedis-practice-lxrhs?file=/src/App.js)
# 🤝 Contributing
Contributions, issues and feature requests are welcome! Feel free to check [issues page](https://github.com/alhaqhassan/jedisdb/issues).
---
_Source: https://npm.io/package/jedisdb · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._