npmpackage.info

Gathering detailed insights and metrics for react-hooks-global-state

Gathering detailed insights and metrics for react-hooks-global-state

react-hooks-global-state - 2.1.0 | npmpackage.info

react-hooks-global-state

[NOT MAINTAINED] Simple global state for React with Hooks API without Context API

2.1.0

1,105

MIT

TypeScript

54.50 kB

Installations

npm install react-hooks-global-state

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Node Version

14.21.1

NPM Version

6.14.17

Pull Requests

Open

5

Total

51

Closed

20

Merged

26

Issues

Open

1

Total

38

Closed

37

Releases

Unable to fetch releases

Languages

2

TypeScript

JavaScript

TypeScript (96.94%)

JavaScript (3.06%)

Developer

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

MIT License

1,105 Stars

278 Commits

62 Forks

12 Watchers

7 Branches

6 Contributors

Updated on May 26, 2025

Maintainers

1

View All 6 Contributors

Package Meta Information

Latest Version

2.1.0

Package Id

react-hooks-global-state@2.1.0

Unpacked Size

54.50 kB

Size

10.72 kB

File Count

16

NPM Version

6.14.17

Node Version

14.21.1

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

react-hooks-global-state

Simple global state for React with Hooks API without Context API

Introduction

This is a library to provide a global state with React Hooks. It has following characteristics.

Optimization for shallow state getter and setter.
- The library cares the state object only one-level deep.
TypeScript type definitions
- A creator function creates hooks with types inferred.
Redux middleware support to some extent
- Some of libraries in Redux ecosystem can be used.

Install

1npm install react-hooks-global-state

Usage

setState style

1import React from 'react';
2import { createGlobalState } from 'react-hooks-global-state';
3
4const initialState = { count: 0 };
5const { useGlobalState } = createGlobalState(initialState);
6
7const Counter = () => {
8  const [count, setCount] = useGlobalState('count');
9  return (
10    <div>
11      <span>Counter: {count}</span>
12      {/* update state by passing callback function */}
13      <button onClick={() => setCount(v => v + 1)}>+1</button>
14      {/* update state by passing new value */}
15      <button onClick={() => setCount(count - 1)}>-1</button>
16    </div>
17  );
18};
19
20const App = () => (
21  <>
22    <Counter />
23    <Counter />
24  </>
25);

reducer style

1import React from 'react';
2import { createStore } from 'react-hooks-global-state';
3
4const reducer = (state, action) => {
5  switch (action.type) {
6    case 'increment': return { ...state, count: state.count + 1 };
7    case 'decrement': return { ...state, count: state.count - 1 };
8    default: return state;
9  }
10};
11const initialState = { count: 0 };
12const { dispatch, useStoreState } = createStore(reducer, initialState);
13
14const Counter = () => {
15  const value = useStoreState('count');
16  return (
17    <div>
18      <span>Counter: {value}</span>
19      <button onClick={() => dispatch({ type: 'increment' })}>+1</button>
20      <button onClick={() => dispatch({ type: 'decrement' })}>-1</button>
21    </div>
22  );
23};
24
25const App = () => (
26  <>
27    <Counter />
28    <Counter />
29  </>
30);

API

createGlobalState

Create a global state.

It returns a set of functions

useGlobalState: a custom hook works like React.useState
getGlobalState: a function to get a global state by key outside React
setGlobalState: a function to set a global state by key outside React
subscribe: a function that subscribes to state changes

Parameters

initialState State

Examples

1import { createGlobalState } from 'react-hooks-global-state';
2
3const { useGlobalState } = createGlobalState({ count: 0 });
4
5const Component = () => {
6  const [count, setCount] = useGlobalState('count');
7  ...
8};

createStore

Create a global store.

It returns a set of functions

useStoreState: a custom hook to read store state by key
getState: a function to get store state by key outside React
dispatch: a function to dispatch an action to store

A store works somewhat similarly to Redux, but not the same.

Parameters

reducer Reducer<State, Action>
initialState State (optional, default (reducer as any)(undefined,{type:undefined}))
enhancer any?

Examples

1import { createStore } from 'react-hooks-global-state';
2
3const initialState = { count: 0 };
4const reducer = ...;
5
6const store = createStore(reducer, initialState);
7const { useStoreState, dispatch } = store;
8
9const Component = () => {
10  const count = useStoreState('count');
11  ...
12};

Returns Store<State, Action>

useGlobalState

useGlobalState created by createStore is deprecated.

Type: function (stateKey: StateKey): any

Meta

deprecated: useStoreState instead

Examples

The examples folder contains working examples. You can run one of them with

1PORT=8080 npm run examples:01_minimal

and open http://localhost:8080 in your web browser.

You can also try them in codesandbox.io: 01 02 03 04 05 06 07 08 09 10 11 13

Blogs

TypeScript-aware React hooks for global state
An alternative to React Redux by React Hooks API (For both JavaScript and TypeScript)
Redux middleware compatible React Hooks library for easy global state management
React Hooks Tutorial on pure useReducer + useContext for global state like Redux and comparison with react-hooks-global-state
Four patterns for global state with React hooks: Context or Redux
Steps to Develop Global State for React With Hooks Without Context

Community Wiki

Persistence
Optional initialState

Empty State

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

47 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-c2jc-4fpr-4vhg
Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9
Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx
Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6
Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6
Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc
Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp
Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27
Warn: Project is vulnerable to: GHSA-4www-5p9h-95mh
Warn: Project is vulnerable to: GHSA-9gqv-wp59-fq42
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
Warn: Project is vulnerable to: GHSA-3j8f-xvm3-ffx4
Warn: Project is vulnerable to: GHSA-j9fq-vwqv-2fm2
Warn: Project is vulnerable to: GHSA-pqw5-jmp5-px4v
Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-76p7-773f-r4q5
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-pq67-2wwv-3xjx
Warn: Project is vulnerable to: GHSA-8cj5-5rvv-wf4v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-g3ch-rx76-35fx
Warn: Project is vulnerable to: GHSA-hc6q-2mpp-qw7j
Warn: Project is vulnerable to: GHSA-4vvj-4cpr-p986
Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6
Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v
Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q

Score

2.5

/10

Last Scanned on 2025-07-14

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.