Troubleshooting

Nothing appears

• Make sure <ToastHost /> is mounted once near the app root.
• Rebuild the native app after installing. JavaScript reloads do not link native code.
• The library requires the New Architecture.

TurboModuleRegistry cannot find SuperToast

Native code is not linked. Run npx pod-install on iOS, rebuild both platforms, and use a development build instead of Expo Go.

iOS build fails after installing

Make sure pods are up to date:

cd ios && pod install --repo-update

Custom font does not render on Android

Font files in assets/fonts must be named after the font family, for example Inter.ttf for fontFamily: 'Inter'.

A style is ignored

Only the keys listed in Styling are supported, so toasts render identically on both platforms.

Still stuck?

Open an issue with your React Native version, platform, and a minimal reproduction.