beautifulinteractions/ beautiful-react-hooks
About the developer
4.3K Stars 
241 Forks 
MIT License 
377 Commits 
13 Opened issues 
Description
๐ฅ A collection of beautiful and (hopefully) useful React hooks to speed-up your components and hooks development ๐ฅ
Services available
Contributors list
A collection of beautiful (and hopefully useful) React hooks to speed-up your components and hooks development
๐ฌ๐ง English | ๐จ๐ณ ็ฎไฝไธญๆ | ๐ฎ๐น Italiano | ๐ช๐ธ Espaรฑol | ๐บ๐ฆ Ukrainian | ๐ง๐ท Brazilian Portuguese | ๐ต๐ฑ Polski | ๐ฏ๐ต ๆฅๆฌ่ช
๐ก Why?
React custom hooks allow to abstract components' business logic into single reusable functions.
So far, we've found that most of the hooks we've created and therefore shared between our internal projects have quite often a
similar gist that involves callback references, events and components' lifecycle.
For this reason we've tried to sum up that gist into
beautiful-react-hooks: a collection of (hopefully) useful React hooks to possibly help other companies and professionals to speed up their development process.
Furthermore, we created a concise yet concrete API having in mind the code readability, focusing to keep the learning curve as lower as possible so that the it can be used and shared in bigger teams.
-- Please before using any hook, read its documentation! --
โ๏ธ Features
- Concise API
- Small and lightweight
- Easy to learn
- Functional approach
- Fully written in JS (although TS types are supported)
๐บ Install
by using
npm:
bash $ npm install beautiful-react-hooks
by using
yarn:
$ yarn add beautiful-react-hooks
๐จ Hooks
- useObservable
- useGlobalEvent
- usePreviousValue
- useValueHistory
- useValidatedState
- useMediaQuery
- useOnlineState
- useViewportSpy
- useSpeechSynthesis and useSystemVoices
- useGeolocation, useGeolocationState and useGeolocationEvents
- useDrag, useDropZone and useDragEvents
- useMouse, useMouseState and useMouseEvents
- useLifecycle, useDidMount and useWillUnmount
- useWindowResize
- useWindowScroll
- useRequestAnimationFrame
- useResizeObserver
- useTimeout
- useConditionalTimeout
- useInterval
- useDebouncedFn
- useThrottledFn
- useLocalStorage
- useSessionStorage
- useStorage
- useDefaultedState
- useRenderInfo
Contributing
Contributions are very welcome and wanted.
To submit your custom hook, please make sure your read our CONTRIBUTING guidelines.
Before submitting a new merge request, please make sure:
- You have updated the package.json version and reported your changes into the CHANGELOG file
- make sure you run
npm test
andnpm build
before submitting your merge request. - make sure you've added the documentation of your custom hook (you can possibly use the HOOKDOCUMENTATIONTEMPLATE to document your custom hook).
- make sure you've updated the
index.d.ts
file with your hook types.
Made with
Credits
This library is provided and sponsored by:
As part of our commitment to support and contribute to the open source community.
Icon made by Freepik from www.flaticon.com