npm i usehooks-ts

💫 Introduction

useHooks(🔥).ts is a React hooks library, written in Typescript and easy to use. It provides a set of hooks that enables you to build your React applications faster. The hooks are built upon the principles of DRY (Don't Repeat Yourself). There are hooks for most common use cases you might need.

The library is designed to be as minimal as possible. It is fully tree-shakable (using the ESM version), meaning that you only import the hooks you need, and the rest will be removed from your bundle making the cost of using this library negligible. Most hooks are extensively tested and are being used in production environments.

Usage example

import { useLocalStorage } from 'usehooks-ts'

function Component() {
  const [value, setValue] = useLocalStorage('my-localStorage-key', 0)

  // ...
}

🪝 Available Hooks

• useBoolean — handles boolean state with useful utility functions.
• useClickAnyWhere — handles click events anywhere on the document.
• useCopyToClipboard — copies text to the clipboard using the Clipboard API.
• useCountdown — manages countdown.
• useCounter — manages a counter with increment, decrement, reset, and setCount functionalities.
• useDarkMode — returns the current state of the dark mode.
• useDebounceCallback — creates a debounced version of a callback function.
• useDebounceValue — returns a debounced version of the provided value, along with a function to update it.
• useDocumentTitle — sets the document title.
• useEventCallback — creates a memoized event callback.
• useEventListener — attaches event listeners to DOM elements, the window, or media query lists.
• useHover — tracks whether a DOM element is being hovered over.
• useIntersectionObserver — tracks the intersection of a DOM element with its containing element or the viewport using the Intersection Observer API.
• useInterval — creates an interval that invokes a callback function at a specified delay using the setInterval API.
• useIsClient — determines if the code is running on the client side (in the browser).
• useIsMounted — determines if the component is currently mounted.
• useIsomorphicLayoutEffect — uses either useLayoutEffect or useEffect based on the environment (client-side or server-side).
• useLocalStorage — uses the localStorage API to persist state across page reloads.
• useMap — manages a key-value Map state with setter actions.
• useMediaQuery — tracks the state of a media query using the Match Media API.
• useOnClickOutside — handles clicks outside a specified element.
• useReadLocalStorage — reads a value from localStorage, closely related to useLocalStorage().
• useResizeObserver — observes the size of an element using the ResizeObserver API.
• useScreen — tracks the screen dimensions and properties.
• useScript — dynamically loads scripts and tracking their loading status.
• useScrollLock — A custom hook that locks and unlocks scroll.
• useSessionStorage — uses the sessionStorage API to persist state across page reloads.
• useStep — manages and navigates between steps in a multi-step process.
• useTernaryDarkMode — manages ternary (system, dark, light) dark mode with local storage support.
• useTimeout — handles timeouts in React components using the setTimeout API.
• useToggle — manages a boolean toggle state in React components.
• useUnmount — runs a cleanup function when the component is unmounted.
• useWindowSize — tracks the size of the window.

💚 Backers

Big thanks go to all our backers! [Become a backer]

Sentry

KATT

Adhi Ravishankar

great-work-told-is

✨ Contributors

Big thanks go to all our contributors! [Become a contributor]

Julien 🖋 💻 🎨 🤔	a777med 💻	Nguyen Tien Dat 💻	Elias Cohenca 🖋	João Deroldo 🐛 💻	Nishit 💻	Jon Koops 💻
LoneRifle 💻	Viktor 🤔 🐛	Bruno Clermont 💬	yoannesbourg 🤔	Strange2x 🤔	Jason Pickens 🐛	Sel-Vin Kuik 🐛
isaac 🐛	Bruno RZN 💻 👀	Nathan Manceaux-Panot 💻 👀	Dien Vu 🤔	Oleg Kusov 🤔	Matthew Guy 🤔	andrewbihl 🐛
lancepollard 🐛	Mukul Bansal 🐛	Jean-Luc Mongrain sur la Brosse 💻 🤔	Nic 🖋	Dan Wood 💻	jo wendenbuerger 🐛	Andrew Nosenko 🐛
CharlieJhonSmith 💻	Sullivan SENECHAL 🤔 🐛 💻	Jason Long 🐛	kxm766 🐛	Quentin 💻 🤔 🖋	Daniel Lazar 💻 🐛	Mark Terrel 🐛 💻
Andreas Herd 🐛	Sonjoy Datta 💻	Ilya Belsky 🐛	James Barrett 💻	AbbalYouness 💻	didriklind 💻 ⚠️	hexp1989 💻
Alvaro Serrano 🖋	Egehan Dülger 💻	PabloLION 🐛 💻	David Sanchez 🐛	Ajay Raja 🐛	Andy Merskin 🤔	Avirup Ghosh 💻 🐛
Sanne Wintrén 🐛	Alessandro 🐛	Andrey Tatarenko 🐛	Anton Rusak 🐛	Mahmood Bagheri 💻	Anver Sadutt 🖋	Bogdan Ailincai 💻
Simeon Griggs 🐛	Kepro 🐛	Jake Lippert 🐛	Tu Nguyen Anh 🐛 💻	Luke Shiels 🐛	Sergei Kolyago 🤔	Adham Akmal Azmi 🐛
Alek Kowalczyk 🐛	Sean Callahan 🐛	Joshua Bean 💻 🐛	Tim Zhao 🐛	Patrick 🐛	Bryce Dorn 💻	angusd3v 💻
Davide Di Simone 🐛	Jack Herrington 🐛	Avi Sharvit 💻 🐛	Nicolae Maties 🐛	Shardul Aeer 🐛	Herlon Aguiar 🐛	Alexis Oney 🖋
curtvict 💻	Josué Cortina 🖋	Alex / KATT 💻	Mourad EL CADI 💻 🐛	James Hulena 🐛	Matthew Hailwood 💻 👀	Michael Norrie 🐛
Valentin Politov 💻	Marnus Weststrate 💻	mancuoj 🖋	Chat Sumlin 💻	Owen Haupt 🐛 🖋	ubarbaxor 💻	Michael Mior 🐛 🖋
Pierre 💻	Harry B 🐛	Valerie 🐛 💻	Steven Vachon 💻	Sean Kirby ⚠️ 💻	Alecsander Farias 💻	Rahul Mishra 💻 👀 🖋
Bryant Smith 💻 🐛	Rob Hannay 💻	Hooriza 💻 🐛	ShanSenanayake 💻	Philip Ghering 💻	Ladislas Dellinger 💻	Haff 💻
Lisandro 💻	Amir hossein rezaei 💻	Nicolas Macian 🐛 💻	Nate Forsyth 💻	satelllte 💻 🐛	Federico Panico 💻	William Pei Yuan 💻
Mihai 💻 🐛	Habib Ogunsola 🖋	Ash Furrow 💻	Daniel Turuș 💻	Rahul Chaudhary 🖋 🐛	Joshua Ojoawo 🤔 🐛	Jack 💻
Jon Linkens 💻 🐛	Jeongjin Oh 🐛	Tianning Li 💻	Lars Artmann 🖋	KBobovskiy 💻	✨ Kathryn Gonzalez ✨ 🖋	Yaroslav Chapelskyi 🖋
Samuel Van Erps 👀	ojolowoblue 🖋	Andrii Kostenko 💻	Akeem Allen 💻 🐛	trongbinhnguyen 🖋	Aniruddha Sil 💻	박찬혁 👀
Anish 💻	Hugo Hutri 🖋	Balz Guenat 💻	OtterGeorge 💻	Samay Sagar 🖋	Pedro Lisboa 🐛	Henrique Malheiros 🐛
Kevin Newman 💻	a503189 🖋	Mourad EL CADI 💻	Pedro Henrique Lopes 💻	Danbi Lee 💻	Connor Jennings 💻	Lucas Gomes 🐛 💻
Martin Zagora 💻	KvD 💻	Alex 💻	Kacey Cleveland 👀	Avirup Ghosh 🐛	yabbal 💻	Craig Patik 🐛
Soldeplata Saketos Candela 💻	TENDOUZHI