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
- Maintenance status: The repo appears not actively maintained as of today (2026-06-09), with the most recent upstream push and package updates in mid-August 2025, roughly 10 months ago.
- Update cadence (as evidenced by recent updates): Updates are sporadic, with changes arriving in 2024-12-31, 2025-01-21 (beta), 2025-02-15, and 2025-08-15/16, and then no further updates since.
AI summary generated
Recent updates
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