HookStack

A growing collection of practical, production-ready React hooks built with modern React and Node.js in mind.

No magic. No hidden behavior. Just sharp, composable hooks you actually reuse.

⚠️ Active development
hookstack is under constant improvement. New hooks and enhancements are added regularly. APIs aim to be stable, but minor refinements may happen as the library evolves.

Why hookstack?

Most hook libraries fall into one of two traps:

• too small to be useful
• too opinionated to be safe

hookstack stays in the middle.

• Focused, reusable hooks
• No unnecessary dependencies
• SSR-safe by default
• Typed with TypeScript
• Works with modern React (18+)
• Built for real-world apps, not demos

If a hook starts behaving like a framework feature, it doesn’t belong here.

Installation

npm install hookstack
# or
pnpm add hookstack
# or
yarn add hookstack

Usage

All hooks are exported from the root package.

import { useToggle, useLocalStorage, useFetch } from 'hookstack';

No deep imports. No internal paths.

Available Hooks

• useToggle
  Manage boolean state with clear on, off, and toggle helpers.

• useLocalStorage
  Persist state in localStorage with SSR safety and JSON handling.

• useCookie
  Read, write, and remove browser cookies with explicit options.

• useCopyToClipboard
  Copy text to the clipboard with status tracking and safe fallbacks.

• useFetch
  Perform simple, abort-safe HTTP requests with manual or automatic execution.

Design Principles

• Primitives first Hooks should do one thing well.

• No fake abstractions If a hook hides important behavior, it’s wrong.

• SSR-safe by default Hooks should not crash during server rendering.

• Escape hatches included Manual control beats clever automation.

Non-goals

hookstack deliberately does not include:

• useAuth
• useForm
• useAxios
• useQuery replacements
• App-specific hooks

Those belong in your application, not a shared library.

Roadmap (high level)

Planned and in-progress hooks include:

• useEvent
• useInterval
• useDebouncedValue
• useMediaQuery
• useClickOutside
• usePrevious
• useDisclosure

The library is actively evolving, with careful API additions over time.

Contributing

Contributions are welcome, but discipline matters.

• Hooks must be reusable
• No app-specific assumptions
• Simplicity over cleverness

Open an issue before large changes.

License

MIT © Gautam Suthar