react-hooks-core 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -32
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
-
<h1>⚡ React
|
|
2
|
+
<h1>⚡ React Hooks Core</h1>
|
|
3
3
|
<p><strong>Production-ready React hooks that solve real-world problems</strong></p>
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/react-hooks-core)
|
|
6
|
+
[](https://github.com/NightDevilPT/react-hooks-core/blob/main/LICENSE)
|
|
7
7
|
[](https://www.typescriptlang.org/)
|
|
8
|
-
[](https://github.com/
|
|
8
|
+
[](https://github.com/NightDevilPT/react-hooks-core)
|
|
9
9
|
</div>
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
## 🎯 What is React
|
|
13
|
+
## 🎯 What is React Hooks Core?
|
|
14
14
|
|
|
15
|
-
**React
|
|
15
|
+
**React Hooks Core** is a comprehensive collection of production-ready React hooks designed to solve common problems you face when building modern React and Next.js applications. Instead of reinventing the wheel for every project, React Hooks Core provides battle-tested, well-documented hooks that work out of the box.
|
|
16
16
|
|
|
17
|
-
Whether you're building a SaaS platform, e-commerce site, dashboard, or any production application, React
|
|
17
|
+
Whether you're building a SaaS platform, e-commerce site, dashboard, or any production application, React Hooks Core helps you ship faster with fewer bugs and better user experiences.
|
|
18
18
|
|
|
19
19
|
---
|
|
20
20
|
|
|
21
21
|
## 💼 Built for Production
|
|
22
22
|
|
|
23
|
-
### Why Production Projects Need React
|
|
23
|
+
### Why Production Projects Need React Hooks Core
|
|
24
24
|
|
|
25
25
|
Every production React application faces the same challenges:
|
|
26
26
|
|
|
@@ -30,7 +30,7 @@ Every production React application faces the same challenges:
|
|
|
30
30
|
- **Responsive Design** - Build adaptive UIs that respond to viewport changes and system preferences
|
|
31
31
|
- **Performance Optimization** - Adapt content quality based on network speed, battery level, and device capabilities
|
|
32
32
|
|
|
33
|
-
**React
|
|
33
|
+
**React Hooks Core solves these problems** with hooks that are:
|
|
34
34
|
- ✅ **SSR-Compatible** - Works seamlessly with Next.js App Router and Pages Router
|
|
35
35
|
- ✅ **Type-Safe** - Full TypeScript support with proper generics and inference
|
|
36
36
|
- ✅ **Well-Tested** - Comprehensive test coverage ensuring reliability
|
|
@@ -40,15 +40,15 @@ Every production React application faces the same challenges:
|
|
|
40
40
|
|
|
41
41
|
---
|
|
42
42
|
|
|
43
|
-
## 🚀 How React
|
|
43
|
+
## 🚀 How React Hooks Core Helps Your Production Projects
|
|
44
44
|
|
|
45
45
|
### ⚡ Faster Development
|
|
46
46
|
|
|
47
|
-
Stop rewriting the same logic for every project. React
|
|
47
|
+
Stop rewriting the same logic for every project. React Hooks Core provides ready-to-use hooks that handle edge cases, error scenarios, and browser compatibility issues you might miss. Focus on building features, not infrastructure.
|
|
48
48
|
|
|
49
49
|
### 🐛 Fewer Bugs
|
|
50
50
|
|
|
51
|
-
Every hook in React
|
|
51
|
+
Every hook in React Hooks Core is thoroughly tested with comprehensive test suites covering initialization, SSR compatibility, state updates, error handling, cleanup, and edge cases. This means fewer bugs in production and more confidence in your code.
|
|
52
52
|
|
|
53
53
|
### 📦 Optimized Bundle Size
|
|
54
54
|
|
|
@@ -56,7 +56,7 @@ Tree-shakeable imports mean you only bundle what you use. Zero dependencies keep
|
|
|
56
56
|
|
|
57
57
|
### 🎯 Better User Experience
|
|
58
58
|
|
|
59
|
-
React
|
|
59
|
+
React Hooks Core hooks respect user preferences and device capabilities. Detect system dark mode, respect reduced motion preferences, adapt to network conditions, and optimize for battery life. Your users will notice the difference.
|
|
60
60
|
|
|
61
61
|
### 🔒 Enhanced Security
|
|
62
62
|
|
|
@@ -85,15 +85,15 @@ Works with React 18+ and Next.js 13+ (both App Router and Pages Router). SSR-com
|
|
|
85
85
|
## 📦 Installation
|
|
86
86
|
|
|
87
87
|
```bash
|
|
88
|
-
npm install react-
|
|
88
|
+
npm install react-hooks-core
|
|
89
89
|
```
|
|
90
90
|
|
|
91
91
|
```bash
|
|
92
|
-
yarn add react-
|
|
92
|
+
yarn add react-hooks-core
|
|
93
93
|
```
|
|
94
94
|
|
|
95
95
|
```bash
|
|
96
|
-
pnpm add react-
|
|
96
|
+
pnpm add react-hooks-core
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
---
|
|
@@ -103,7 +103,7 @@ pnpm add react-hookify
|
|
|
103
103
|
All hooks work out of the box with zero configuration. Simply import what you need:
|
|
104
104
|
|
|
105
105
|
```tsx
|
|
106
|
-
import { useDeviceDetect, useOnline, useIdle, useMediaQuery } from 'react-
|
|
106
|
+
import { useDeviceDetect, useOnline, useIdle, useMediaQuery } from 'react-hooks-core'
|
|
107
107
|
```
|
|
108
108
|
|
|
109
109
|
Tree-shakeable imports mean you only bundle what you use, keeping your production bundle size minimal.
|
|
@@ -112,7 +112,7 @@ Tree-shakeable imports mean you only bundle what you use, keeping your productio
|
|
|
112
112
|
|
|
113
113
|
## 📚 Available Hooks
|
|
114
114
|
|
|
115
|
-
React
|
|
115
|
+
React Hooks Core provides hooks across multiple categories to help you build production-ready applications:
|
|
116
116
|
|
|
117
117
|
### 🌐 Browser & Device Hooks
|
|
118
118
|
|
|
@@ -132,13 +132,13 @@ For detailed documentation on each hook, visit the [documentation folder](src/br
|
|
|
132
132
|
|
|
133
133
|
## 🎨 Live Demo
|
|
134
134
|
|
|
135
|
-
An interactive demo showcasing all hooks is available in the `next-example` folder. See React
|
|
135
|
+
An interactive demo showcasing all hooks is available in the `next-example` folder. See React Hooks Core in action with real-time updates and visual indicators.
|
|
136
136
|
|
|
137
|
-
Run locally: `npm run build && npm link && cd next-example && npm link react-
|
|
137
|
+
Run locally: `npm run build && npm link && cd next-example && npm link react-hooks-core && npm run dev`
|
|
138
138
|
|
|
139
139
|
---
|
|
140
140
|
|
|
141
|
-
## 🌟 Why Choose React
|
|
141
|
+
## 🌟 Why Choose React Hooks Core for Production?
|
|
142
142
|
|
|
143
143
|
### Problem: Reinventing the Wheel
|
|
144
144
|
|
|
@@ -146,7 +146,7 @@ Every React project needs device detection, online status monitoring, responsive
|
|
|
146
146
|
|
|
147
147
|
### Solution: Production-Ready Hooks
|
|
148
148
|
|
|
149
|
-
React
|
|
149
|
+
React Hooks Core provides battle-tested hooks that:
|
|
150
150
|
- ✅ Work out of the box with React 18+ and Next.js 13+
|
|
151
151
|
- ✅ Handle SSR/CSR seamlessly without configuration
|
|
152
152
|
- ✅ Include proper TypeScript types with full inference
|
|
@@ -169,7 +169,7 @@ React Hookify provides battle-tested hooks that:
|
|
|
169
169
|
|
|
170
170
|
## 🗺️ Roadmap
|
|
171
171
|
|
|
172
|
-
We're actively expanding React
|
|
172
|
+
We're actively expanding React Hooks Core with more production-ready hooks across multiple categories:
|
|
173
173
|
|
|
174
174
|
### 🔜 Coming Soon
|
|
175
175
|
|
|
@@ -206,7 +206,7 @@ Fast builds with `tsup` supporting both CommonJS and ES modules, TypeScript decl
|
|
|
206
206
|
|
|
207
207
|
## 🤝 Contributing
|
|
208
208
|
|
|
209
|
-
We welcome contributions from the community! Whether it's bug fixes, new hooks, documentation improvements, or feature suggestions, your input helps make React
|
|
209
|
+
We welcome contributions from the community! Whether it's bug fixes, new hooks, documentation improvements, or feature suggestions, your input helps make React Hooks Core better for everyone.
|
|
210
210
|
|
|
211
211
|
Please see our [Contributing Guide](CONTRIBUTING.md) for guidelines on code style, testing requirements, and the pull request process.
|
|
212
212
|
|
|
@@ -216,30 +216,30 @@ Please see our [Contributing Guide](CONTRIBUTING.md) for guidelines on code styl
|
|
|
216
216
|
|
|
217
217
|
MIT License - see [LICENSE](LICENSE) file for details
|
|
218
218
|
|
|
219
|
-
Copyright (c) 2025 React
|
|
219
|
+
Copyright (c) 2025 React Hooks Core
|
|
220
220
|
|
|
221
221
|
---
|
|
222
222
|
|
|
223
223
|
## 🔗 Links
|
|
224
224
|
|
|
225
|
-
- [NPM Package](https://www.npmjs.com/package/react-
|
|
226
|
-
- [GitHub Repository](https://github.com/
|
|
227
|
-
- [Issue Tracker](https://github.com/
|
|
225
|
+
- [NPM Package](https://www.npmjs.com/package/react-hooks-core)
|
|
226
|
+
- [GitHub Repository](https://github.com/NightDevilPT/react-hooks-core)
|
|
227
|
+
- [Issue Tracker](https://github.com/NightDevilPT/react-hooks-core/issues)
|
|
228
228
|
- [Changelog](CHANGELOG.md)
|
|
229
229
|
|
|
230
230
|
---
|
|
231
231
|
|
|
232
232
|
## 💬 Support
|
|
233
233
|
|
|
234
|
-
- 🐛 [Report a bug](https://github.com/
|
|
235
|
-
- ✨ [Request a feature](https://github.com/
|
|
236
|
-
- 💡 [Ask a question](https://github.com/
|
|
234
|
+
- 🐛 [Report a bug](https://github.com/NightDevilPT/react-hooks-core/issues/new?template=bug_report.md)
|
|
235
|
+
- ✨ [Request a feature](https://github.com/NightDevilPT/react-hooks-core/issues/new?template=feature_request.md)
|
|
236
|
+
- 💡 [Ask a question](https://github.com/NightDevilPT/react-hooks-core/discussions)
|
|
237
237
|
|
|
238
238
|
---
|
|
239
239
|
|
|
240
240
|
<div align="center">
|
|
241
241
|
<p>Made with ❤️ by developers, for developers</p>
|
|
242
242
|
<p>
|
|
243
|
-
<a href="https://github.com/
|
|
243
|
+
<a href="https://github.com/NightDevilPT/react-hooks-core">⭐ Star us on GitHub</a>
|
|
244
244
|
</p>
|
|
245
245
|
</div>
|