npmpackage.info

Gathering detailed insights and metrics for use-persisted-state

Other packages similar to use-persisted-state

@types/use-persisted-state

0.3.5

TypeScript definitions for use-persisted-state

use-hashed-state

0.3.5

Safely store data in localstorage with an unique key of any type, even a component

px-use-persisted-state

0.4.7

A custom React Hook that provides a multi-instance, multi-tab/browser shared and persistent state.

@utilityjs/use-persisted-state

1.1.3

A React hook that provides a SSR-friendly multi-tab persistent state.

Gathering detailed insights and metrics for use-persisted-state

use-persisted-state - 0.3.3 | npmpackage.info

use-persisted-state

A custom React Hook that provides a multi-instance, multi-tab/browser shared and persistent state.

0.3.3

1,382

MIT

JavaScript

888.00 B

16,979,165 2.3

Installations

npm install use-persisted-state

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

14.15.1

NPM Version

6.14.8 Score

97.9

Supply Chain

92.1

Quality

75.3

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

23

Total

49

Closed

12

Merged

14

Issues

Open

22

Total

29

Closed

7

Releases

Unable to fetch releases

Languages

JavaScript

JavaScript (100%)

Developer

donavon

Download Statistics

Total Downloads

16,979,165

Last Day

2,178

Last Week

119,272

Last Month

432,885

Last Year

3,840,926

GitHub Statistics

MIT License

1,382 Stars

33 Commits

96 Forks

8 Watchers

24 Branches

7 Contributors

Updated on Jun 16, 2025

Bundle Size

2.03 kB

Minified

888.00 B

Minified + Gzipped

Bundlephobia

Maintainers

View All 7 Contributors

Package Meta Information

Latest Version

0.3.3

Package Id

use-persisted-state@0.3.3

Size

4.78 kB

NPM Version

6.14.8

Node Version

14.15.1

Published on

Nov 19, 2020

Total Downloads

Cumulative downloads

Total Downloads

16,979,165

Last Day

-81.8%

2,178

Compared to previous day

Last Week

-19.8%

119,272

Compared to previous week

Last Month

50.4%

432,885

Compared to previous month

Last Year

20.5%

3,840,926

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

use-persisted-state

A custom React Hook that provides a multi-instance, multi-tab/browser shared and persistent state.

use-persisted-state is not a hook itself, but is a factory that accepts a storage key and an optional storage provider (default = localStorage) and returns a hook that you can use as a direct replacement for useState.

Features

???? Persists the state to localStorage

???? Syncs between tabs and/or browser windows

???? Shares state w/multiple hooks on a page

Requirement

To use use-persisted-state, you must use react@16.8.0 or greater which includes Hooks.

Installation

1$ npm i use-persisted-state

Example

Let's take a look at how you can use use-persisted-state. Here we have an example of a typical up/down counter.

1import { useState } from 'react';
2
3const useCounter = initialCount => {
4  const [count, setCount] = useState(initialCount);
5
6  return {
7    count,
8    increment: () => setCount(currentCount => currentCount + 1),
9    decrement: () => setCount(currentCount => currentCount - 1),
10  };
11};
12
13export default useCounter;

Let's replace the import of react with an import from use-persisted-state. And we'll call createPersistedState (the factory function). This will return a useCounterState hook that we can use in place of useState.

The complete code is as follows.

1import createPersistedState from 'use-persisted-state';
2const useCounterState = createPersistedState('count');
3
4const useCounter = initialCount => {
5  const [count, setCount] = useCounterState(initialCount);
6
7  return {
8    count,
9    increment: () => setCount(currentCount => currentCount + 1),
10    decrement: () => setCount(currentCount => currentCount - 1),
11  };
12};
13
14export default useCounter;

The state is shared with any other hook using the same key, either on the same page, across tabs, or even browser windows.

For example, open two copies of your app in two tabs or even two windows. Any changes to state in one tab will be rendered on the other tab.

You can also close the browser and the next time you run your app, the state will be rendered as it was before you closed your browser.

License

MIT Licensed

Contributors

Thanks goes to these wonderful people (emoji key):

_{Donavon West}
???? ⚠️ ???? ???? ???? ???? ???? ????

_{Karol Majewski}
????

_{Octave Raimbault}
????

_{Dennis Morello}
????

_Florent
????

_{Mark Adamson}
????

_{Vitor Dino}
????

This project follows the all-contributors specification. Contributions of any kind welcome!

No vulnerabilities found.

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.

2

Code-Review

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

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

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

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

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-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-w8qv-6jwh-64r5
Warn: Project is vulnerable to: GHSA-257v-vj4p-3w2h
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44
Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988
Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
Warn: Project is vulnerable to: GHSA-7r28-3m3f-r2pr
Warn: Project is vulnerable to: GHSA-r8j5-h5cx-65gg
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq
Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488
Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g
Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9
Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm
Warn: Project is vulnerable to: GHSA-7wpw-2hjm-89gp
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3
Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-566m-qj78-rww5
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-hwj9-h5mp-3pm3
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc
Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-w5p7-h5w8-2hfq
Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

2.3

/10

Last Scanned on 2025-06-23

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.

Learn More

Other packages similar to use-persisted-state

Other packages similar to use-persisted-state

use-persisted-state

Installations

Developer Guide

No

CommonJS

14.15.1

6.14.8

Score

Pull Requests

23

49

12

14

Issues

22

29

7

Releases

Unable to fetch releases

Languages

Developer

donavon

Download Statistics

GitHub Statistics

Bundle Size

2.03 kB

888.00 B

Maintainers

Package Meta Information

Total Downloads

16,979,165

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

use-persisted-state

Features

Requirement

Installation

Example

License

Contributors

10

10

2

0

0

0

0

0

0

2.3

/10