Installation

Install the package and its peer dependencies, and set up the app root.

Install the package

Note

It is not on npm yet. Install it from GitHub; npm builds it after cloning, which takes a minute or two.

Terminal
npm install github:VanitasCaesar1/expo-hot-toast

Install the peer dependencies

Tip

Building a React web app without React Native (Next.js, Vite)? Skip this step and follow Web apps instead.

Terminal
npx expo install expo-glass-effect expo-haptics react-native-reanimated \
  react-native-worklets react-native-gesture-handler \
  react-native-safe-area-context react-native-svg

Tip

Use npx expo install rather than npm install, so you get the versions that match your Expo SDK.

Check the Babel plugin

Expo: nothing to do. babel-preset-expo adds the Worklets plugin automatically when react-native-worklets is installed.

React Native without Expo’s preset: add the plugin last in babel.config.js:

babel.config.js
module.exports = {
  presets: ['module:@react-native/babel-preset'],
  plugins: ['react-native-worklets/plugin'],
};

Wrap the app root

Gestures need a GestureHandlerRootView at the root, and the Toaster reads safe-area insets from a SafeAreaProvider. Expo Router already renders a SafeAreaProvider; add the other.

App.tsx
import { GestureHandlerRootView } from 'react-native-gesture-handler';
import { SafeAreaProvider } from 'react-native-safe-area-context';
import { Toaster } from 'expo-hot-toast';

export default function App() {
  return (
    <GestureHandlerRootView style={{ flex: 1 }}>
      <SafeAreaProvider>
        <Home />
        <Toaster />
      </SafeAreaProvider>
    </GestureHandlerRootView>
  );
}

Render <Toaster /> once, after the rest of the app, so toasts draw on top.

Requirements

Expo SDK55 or later (tested on 57)
React Native0.80 or later (tested on 0.86)
React19
Reanimated4 or later, with react-native-worklets
Liquid GlassAn app built with the iOS 26 SDK (Xcode 26 or later), running on iOS 26

Everything else falls back to the opaque surface, so the same build runs on older iOS and on Android.

Next

Show your first toast.

Last updated on Oct 25, 2026

Edit on GitHub