+## Sponsors
+
+Sponsoring ReactUse puts your product in front of the React developers who install `@reactuses/core` every month — your logo right here at the top of the README, and on [reactuse.com/sponsor](https://reactuse.com/sponsor/). Live reach:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
All sponsor slots are currently open — claim one and your logo goes live within 48 hours. Tiers, benefits and company invoicing: reactuse.com/sponsor.
+
## Introduction
**ReactUse** is a comprehensive collection of **100+ essential React Hooks** for building modern React applications. Inspired by [VueUse](https://vueuse.org/), it provides production-ready hooks for browser APIs, state management, sensors, animations, DOM elements, and more.
@@ -138,8 +161,6 @@ This project is heavily inspired by the following awesome projects.
---
-## Sponsor Me
-
-If my work has helped you, consider buying me a cup of coffee. Thank you very much🥰!.
+## Support ReactUse
-[Buy me a coffee](https://www.buymeacoffee.com/lianwenwu)
+ReactUse is free and MIT-licensed, maintained in spare time. If it saved you a day of work, consider [becoming a sponsor](https://github.com/sponsors/childrentime) (from $5/month) or [buying me a coffee](https://www.buymeacoffee.com/lianwenwu) — it keeps the hooks maintained and the docs interactive. 🥰
diff --git a/packages/website-astro/public/llms-full.txt b/packages/website-astro/public/llms-full.txt
index 328900aa..1cbb2484 100644
--- a/packages/website-astro/public/llms-full.txt
+++ b/packages/website-astro/public/llms-full.txt
@@ -228,14 +228,13 @@ React hook that facilitates the storage, updating and deletion of values within
### Notes
- **SSR considerations**: Pass a `defaultValue` when using SSR so the hook has a value before `document.cookie` is available on the client.
-- **No cross-component sync**: Updating a cookie in one component does not automatically trigger re-renders in other components using the same key. Use a broadcast mechanism if needed.
-- See also `useLocalStorage` and `useSessionStorage` for Web Storage alternatives that provide cross-tab synchronization via the `storage` event.
+- **Same-tab sync**: Updating a cookie in one component automatically re-renders sibling `useCookie` instances using the same key in the same tab. Cookies fire no native cross-tab event, so this does **not** propagate across tabs (unlike `useLocalStorage`/`useSessionStorage`).
+- **`refreshCookie`**: Only needed to pick up changes made *outside* the hook — a server `Set-Cookie`, a direct `document.cookie` write, or the CookieStore API. Sibling hook instances no longer need it.
:::note
-When you use setCookieValue with useCookie hook that shares the same key across multiple components,
-it does not trigger an update in the other components using this hook.
-
- If you want a broadcast effect, you can refer to the following https://github.com/childrentime/reactuse/issues/91
+`useCookie` instances that share the same key stay in sync within the same tab:
+calling `updateCookie` in one component re-renders the others automatically. (Earlier
+versions did not — a manual broadcast was required; that is no longer necessary.)
:::
## Usage
@@ -286,6 +285,46 @@ function Demo() {
```
+## Same-tab sync
+
+Two components using the same cookie key stay in sync within the tab — click a button in either panel and the other updates immediately, no manual broadcast and no reload:
+
+```tsx live noInline
+function CookiePanel({ label }) {
+ const [value, updateCookie] = useCookie("shared-demo-cookie", { path: "/" }, "A");
+ return (
+
+ {label} reads: {value ?? "(empty)"}
+
+
+
+
+
+
+
+ );
+}
+
+function Demo() {
+ return (
+
+
Click a button in either panel — the other updates in the same tab:
+
+
+
+ );
+}
+
+render();
+```
+
---
## useCountDown
@@ -714,7 +753,7 @@ React side-effect hook that manages a single `localStorage` key
### Notes
- **Persistence**: Data survives page reloads and browser restarts. Use `useSessionStorage` if you only need data for the current session.
-- **Cross-tab sync**: By default, the hook listens for `storage` events so changes in one tab update other tabs. Disable this with `listenToStorageChanges: false`.
+- **Cross-tab & same-tab sync**: Every component bound to the same key stays in sync — within the current tab (always on, no reload) and across other tabs (via the `storage` event). `listenToStorageChanges: false` disables only the cross-tab listener; same-tab sync stays active.
- **Custom serialization**: For objects or non-string values, provide `serializer.read` and `serializer.write` functions in the options. The default behavior uses JSON serialization for objects and raw strings for string values.
- See also `useSessionStorage` for session-scoped storage and `useCookie` for cookie-based persistence.
@@ -772,6 +811,45 @@ function Demo() {
```
+## Same-tab sync
+
+Two components bound to the same key stay in sync within the tab — not just across tabs. Click a button in one panel and the other updates immediately, no reload:
+
+```tsx live noInline
+function StoragePanel({ label }) {
+ const [value, setValue] = useLocalStorage("shared-demo-key", "A");
+ return (
+
+ {label} reads: {String(value ?? "(empty)")}
+
+
+
+
+
+
+ );
+}
+
+function Demo() {
+ return (
+
+
Click a button in one panel — the other updates in the same tab:
+
+
+
+ );
+}
+
+render();
+```
+
---
## useMap
@@ -1119,7 +1197,7 @@ React side-effect hook that manages a single `sessionStorage` key
### Notes
- **Session-scoped**: Unlike `localStorage`, data in `sessionStorage` is cleared when the tab or browser is closed. Use `useLocalStorage` for long-lived persistence.
-- **Cross-tab sync**: The hook listens for `storage` events by default. Disable with `listenToStorageChanges: false`.
+- **Same-tab sync**: Components bound to the same key in one tab stay in sync — updating one re-renders the others without a reload. (`sessionStorage` is per-tab, so this does not cross tabs.) The cross-tab `storage` listener is on by default; disable it with `listenToStorageChanges: false`.
- **Custom serialization**: Provide `serializer.read` and `serializer.write` in the options for non-string data types.
- See also `useLocalStorage` for persistent storage and `useCookie` for cookie-based persistence.
@@ -7826,4 +7904,4 @@ function Demo() {
---
-Generated: 2026-05-20T20:21:53.456Z | Total hooks: 114
+Generated: 2026-08-11T02:11:13.038Z | Total hooks: 114
diff --git a/packages/website-astro/public/llms.txt b/packages/website-astro/public/llms.txt
index ae330392..29bb2702 100644
--- a/packages/website-astro/public/llms.txt
+++ b/packages/website-astro/public/llms.txt
@@ -1110,4 +1110,4 @@ PDD (Pinduoduo), Shopee, Ctrip, Bambu Lab
Unlicense - Use freely without restrictions
---
-Generated: 2026-05-20T20:21:53.426Z | Total Hooks: 114
+Generated: 2026-08-11T02:11:13.001Z | Total Hooks: 114
diff --git a/packages/website-astro/src/content/docs-zh-hans/sponsor.md b/packages/website-astro/src/content/docs-zh-hans/sponsor.md
index f0a794a3..32cafad2 100644
--- a/packages/website-astro/src/content/docs-zh-hans/sponsor.md
+++ b/packages/website-astro/src/content/docs-zh-hans/sponsor.md
@@ -1,10 +1,61 @@
---
-title: 赞助支持
+title: 赞助 ReactUse
sidebar_label: 赞助支持
-description: "支持 ReactUse——如果 @reactuses/core 对你有帮助,欢迎赞助这个 React hooks 库的持续开发与维护。"
+description: "赞助 ReactUse——让你的产品出现在每月安装 @reactuses/core 超过 160 万次的 React 开发者面前。金、银、铜三档赞助，README 与官网 logo 展示位。"
---
-# 支持我
+# 赞助 ReactUse
-如果我的工作对您有帮助，考虑给我买杯咖啡吧，非常感谢！
+ReactUse 免费、MIT 协议开源，由维护者利用业余时间维护。赞助不仅支撑着 100+ hooks 的持续维护、SSR 兼容与交互式文档，也是把你的产品直接呈现给一线 React 开发者的最有效方式。
-[Buy me a coffee](https://www.buymeacoffee.com/lianwenwu)
+## 为什么值得赞助
+
+- [`@reactuses/core`](https://www.npmjs.com/package/@reactuses/core) **每月 npm 安装量超过 160 万次**——你的 logo 会出现在开发者正在写代码的那一刻
+- **100+ 生产可用的 hooks**，拼多多、Shopee、携程等公司在生产环境使用
+- **reactuse.com 每月出现在 10 万+ 次 Google 搜索中**——文档是开发者反复查阅的日常参考，不是一次性流量
+- **纯开发者受众**：看到你 logo 的人，正是天天为团队选型库、工具和基础设施的人
+
+## 赞助档位
+
+| 档位 | 每月 | 你将获得 |
+| --- | --- | --- |
+| 🥇 **金牌赞助** | $500 | 大尺寸 logo + 链接，置于 **GitHub README 顶部**及本页。首位展示，曝光最大化。 |
+| 🥈 **银牌赞助** | $150 | 中尺寸 logo + 链接，展示于 GitHub README 及本页。 |
+| 🥉 **铜牌赞助** | $50 | 小尺寸 logo + 链接，展示于 GitHub README 及本页。 |
+| ☕ **支持者** | $5 | 你的名字列在本页 + 我们真诚的感谢。 |
+
+所有档位均通过 [**GitHub Sponsors**](https://github.com/sponsors/childrentime) 结算——发票由 GitHub 开具，多数公司无需走采购流程即可报销。随时可取消。
+
+**logo 会在赞助后 48 小时内上线**——README 和本页同步展示，亮色 / 暗色模式都会适配。
+
+## 当前赞助商
+
+以上所有展示位目前**全部空缺**——第一位金牌赞助商将独享这个每周被数千名开发者看到的 README 头部位置。
+
+
+
+## 如何贊助
+
+- **按月贊助（公司或個人）：** [github.com/sponsors/childrentime](https://github.com/sponsors/childrentime)
+- **一次性支持：** [Buy me a coffee](https://www.buymeacoffee.com/lianwenwu)，或在 GitHub Sponsors 選擇一次性金額
+- **客製合作**（其他展示位置、直接開票、長期合作）：來信 [wul55267@gmail.com](mailto:wul55267@gmail.com)——48 小時內回覆
+
+## 贊助資金的去向
+
+贊助將直接用於維護工作：修復 bug 與審查 PR、保持每個 hook 相容新版 React 與瀏覽器、撰寫測試與互動式文件，以及支付基礎設施費用（CI、搜尋、託管）。沒有中間環節——100% 投入開發。
+
+感謝你讓開源永續。🥰
+
+
diff --git a/packages/website-astro/src/content/docs/sponsor.md b/packages/website-astro/src/content/docs/sponsor.md
index 7f762b50..873b9d94 100644
--- a/packages/website-astro/src/content/docs/sponsor.md
+++ b/packages/website-astro/src/content/docs/sponsor.md
@@ -1,10 +1,61 @@
---
-title: sponsor
+title: Sponsor ReactUse
sidebar_label: sponsor
-description: "Support ReactUse — if @reactuses/core has helped you, consider sponsoring the project's continued development and maintenance."
+description: "Sponsor ReactUse — put your product in front of the React developers who install @reactuses/core 1.6M+ times a month. Gold, Silver and Bronze tiers with README + website logo placement."
---
-# Sponsor Me
+# Sponsor ReactUse
-If my work has helped you, consider buying me a cup of coffee. Thank you very much🥰!.
+ReactUse is free, MIT-licensed and maintained in spare time. Sponsorship is what keeps 100+ hooks maintained, SSR-safe and documented with interactive demos — and it's also the single most effective way to put your product in front of working React developers.
-[Buy me a coffee](https://www.buymeacoffee.com/lianwenwu)
\ No newline at end of file
+## Why sponsor
+
+- **1.6M+ npm installs per month** of [`@reactuses/core`](https://www.npmjs.com/package/@reactuses/core) — your logo reaches developers at the exact moment they're building
+- **100+ production-ready hooks**, used in production at PDD, Shopee and Ctrip
+- **reactuse.com appears in 100k+ Google searches every month** — the docs are a daily reference, not a one-time visit
+- A **developer-only audience**: the people who see your logo choose libraries, tools and infrastructure for a living
+
+## Tiers
+
+| Tier | Per month | What you get |
+| --- | --- | --- |
+| 🥇 **Gold** | $500 | Large logo + link at the **top of the GitHub README** and this page. First position, maximum visibility. |
+| 🥈 **Silver** | $150 | Medium logo + link in the GitHub README and on this page. |
+| 🥉 **Bronze** | $50 | Small logo + link in the GitHub README and on this page. |
+| ☕ **Backer** | $5 | Your name listed on this page + our sincere gratitude. |
+
+All tiers are billed through [**GitHub Sponsors**](https://github.com/sponsors/childrentime) — invoices are issued by GitHub, so most companies can expense it without a procurement process. Cancel anytime.
+
+**Logos go live within 48 hours** of sponsorship — in the README, on this page, in both light and dark mode.
+
+## Current sponsors
+
+Every slot above is currently **open** — the first Gold sponsor gets the top of a README seen by thousands of developers a week, exclusively.
+
+
+
+
+
+
+
+## How to sponsor
+
+- **Monthly (companies & individuals):** [github.com/sponsors/childrentime](https://github.com/sponsors/childrentime)
+- **One-time:** [Buy me a coffee](https://www.buymeacoffee.com/lianwenwu), or a one-time amount on GitHub Sponsors
+- **Custom arrangements** (different placement, direct invoicing, longer commitments): email [wul55267@gmail.com](mailto:wul55267@gmail.com) — replies within 48 hours
+
+## Where the money goes
+
+Sponsorship directly funds maintenance: fixing bugs and reviewing PRs, keeping every hook compatible with new React and browser releases, writing tests and interactive documentation, and covering infrastructure (CI, search, hosting). No middlemen — 100% goes to development.
+
+Thank you for keeping open source sustainable. 🥰
+
+
+ 
