Welcome to the expo-hot-toast docs
The react-hot-toast API for Expo and React Native, drawn in Apple's Liquid Glass on iOS 26, frosted glass on the web and a designed surface on Android. Have your agent set it up, or start with the guides below.
Quick start
Install it, mount one Toaster, and show your first toast in a few minutes.
API reference
Every function on toast, every option, every Toaster prop, with types and defaults.
Theming
Colours, shape, type and motion, in light and dark, and the glass settings.
From react-hot-toast
Know it from the web? What carries over, and the few things that differ.
Explore by feature
Toast typesPlain, success, error, info, warning, loading and custom toasts, their icons, and updating one in place.Rich toastsProgress bars, steps, expandable details, Undo countdowns, notifications, banners, a HUD and the island.PromisesOne toast that follows a promise from loading to its outcome.Actions and dismissingUndo buttons, the close button, and tap, swipe and press-and-hold.PositionsSix positions, spacing, several Toasters, and toasts above modals.Timing and the queueDurations, the visible limit, what happens to extra toasts, and deduplication.CustomisingPresets, animations, your own icons, a style or class for each part, and themes from your app.Custom renderingChange what a toast contains, draw it yourself, or build your own Toaster.AccessibilityWhat screen readers hear, and how toasts follow Reduce Motion and Reduce Transparency.Theme tokensEvery token, with its light and dark default.
Explore by platform
iOS 26Apple's Liquid Glass, through expo-glass-effect.AndroidA Material 3 snackbar by default, in light and dark.WebFrosted glass in Expo web, or in any React app (Next.js, Vite) with no React Native.ExpoSDK 55 or later; tested on 57, with Expo Router.React NativeWithout Expo too: one Babel plugin to add.Older iOSThe opaque surface, before iOS 26 and with Reduce Transparency.
Beyond the basics
Platform supportWhat has been tested where, on which versions, and the known limitations.Design notesWhy the queue, the timing and the glass work the way they do.For AI toolsThe docs as plain text: llms.txt for an index, llms-full.txt for everything.ChangelogWhat changed in each release, and what is coming.
What did you think of this content?
Glad it helped. A star on GitHub is how other people find it.
Thank you. The issue that just opened goes straight to the maintainer; say what was missing and the page gets fixed.