Skip to main content
Version: Next



Localstorage hook for React. Syncs with localstorage values across components and browser windows automatically. Sets and retrieves a key from localStorage and subscribes to it for updates across windows.


npm install --save rooks

Importing the hook​

import { useLocalstorage } from "rooks";


function Demo() {
const [value, set, remove] = useLocalstorage("my-value", 0);
// Can also be used as {value, set, remove}

return (
Value is {value}
<button onClick={() => set(value !== null ? value + 1 : 0)}>
<button onClick={remove}>Remove </button>

render(<Demo />);


Argument valueTypeDescriptionDefualt
keystringKey of the localStorage objectundefined
defaultValueanyDefault initial valuenull


Returns an array or an object with following items:

Return valueTypeDescription
valueanyvalue stored in localStorage
set(newValue: any) => voidset value stored in localStorage
remove() => voidremove value stored in localStorage

Codesandbox Example​

Basic Usage​

Join Bhargav's discord server​

You can click on the floating discord icon at the bottom right of the screen and talk to us in our server.