react-hot-toast provides lightweight, customizable toast notifications for React, with features like a promise API for automatic loaders and accessible notifications. It uses headless hooks so developers can create their own toast UI (for example with useToaster), and a Toaster component to render notifications emitted via toast() in the app.
Project status
- Actively maintained, with very recent updates (latest push 2026-09-16, and v2.6.1 released on 2026-09-16), indicating ongoing responsiveness to ecosystem concerns (Tailwind/CSS override ergonomics, subscriber/unmount regression fix, and pnpm strict TypeScript resolution).
- Apparent cadence is inconsistent but currently active, with a long gap between v2.6.0 (2025-08-15) and v2.6.1 (2026-09-16), plus earlier major feature work in 2025 and 2023.
AI summary generated
Recent updates
v2.6.1
v2.6.1 focuses on improving Tailwind/CSS override ergonomics for toast styling, and fixes a regression where toast updates could stop when multiple subscribers shared the same toasterId and one unmounted. It also addresses pnpm strict TypeScript resolution by adding optional @types peer dependencies for React packages.
v2.6.0
v2.6.0 adds multi-toaster support by introducing a toasterId that routes toast state to a specific Toaster instance. It also updates the build pipeline to minify inline templates (in line with “minify inlined CSS” in the release notes).
BreakingFeaturesv2.5.2
v2.5.2 primarily addresses a race condition fix, plus a TypeScript typing update to use React.ReactElement instead of JSX.Element in several exported types and component props. The code changes also include some CI/tooling adjustments (pnpm setup) and contributor-facing metadata updates in package.json.
v2.6.0-beta.0
v2.6.0-beta.0 introduces multi-toaster support by adding a `toasterId` concept and routing toast actions to the correct toaster instance. It also adds more ergonomic APIs for bulk operations (`dismissAll` and `removeAll`) and updates the toaster DOM attribute usage for the rendered container.
Featuresv2.5.1
react-hot-toast v2.5.1 adds enhancements to `toast.promise()` by allowing optional success and error messages, and by accepting an async function as the promise source. It also introduces a customizable `removeDelay` setting and refactors the internal logic that schedules toast removal after dismissal.
Featuresv2.4.1
v2.4.1 focuses on improving React Server Components (Next.js 13 App Router) compatibility by adjusting the distributed build output. The diff also includes internal toolchain updates (tsup/TypeScript) and unrelated changes to the project documentation site.
Breakingv2.4.0
v2.4.0 focuses on improving toast height handling so layout changes can be reflected reliably, using a MutationObserver-based approach. The release notes also mention internal handler restructuring and fixes related to unit tests, including new test scaffolding.
Featuresv2.3.0
Release v2.3.0 is presented as a build and bundle focused update, including exposing a new headless entry point at `react-hot-toast/headless`, making bundles smaller, and speeding up dev builds. In the provided diff, the most notable changes are around documentation/site integration and npm packaging configuration rather than direct library runtime code.
Featuresv2.3.0-beta.1
v2.3.0-beta.1 makes the package distribution more ESM-compliant by switching the ESM artifacts to .mjs and updating package.json entrypoints accordingly. It also cleans up the build setup by renaming the entry file to index.ts and removing the prepare script.
Breakingv2.3.0-beta
v2.3.0-beta focuses on switching the library build and packaging from tsdx to tsup (esbuild-backed) and adopting pnpm. It also adds a new dedicated entrypoint for headless usage at react-hot-toast/headless, alongside various docs/site modernization changes.
Featuresv2.2.0
v2.2.0 primarily updates the public TypeScript surface by exposing additional core types, bumps the goober dependency, and adjusts toast rendering to preserve line breaks. It also includes several documentation/example fixes.
Features