~/docs

Getting started

sileo-native is the toast from sileo for React Native and Expo: the same API, and the same pill that melts into a card, drawn with Skia on the UI thread.

Install

npx expo install sileo-native @shopify/react-native-skia react-native-reanimated react-native-worklets react-native-gesture-handler react-native-svg react-native-safe-area-context
Copy
Every peer dependency ships in Expo Go, so there is no development build to make. Reanimated 4 needs the New Architecture, which is the default from Expo SDK 52.

Add the Toaster

Render one Toaster after your app, inside your providers:
import { Toaster } from 'sileo-native'; export default function App() { return ( <> <YourApp /> <Toaster position="top-center" theme="system" /> </> ); }
Copy
With a SafeAreaProvider in the tree (Expo Router adds one), toasts sit clear of the notch and the home indicator.

Fire a toast

Import sileo anywhere, no hook or context needed:
import { sileo } from 'sileo-native'; sileo.success({ title: 'Changes Saved', description: 'Your profile is up to date.', });
Run
Copy
A toast with a description opens into a card on its own, then closes before it goes. Tap it to open it yourself, and swipe it away to dismiss it.

Promises

sileo.promise(saveProfile(), { loading: { title: 'Saving' }, success: { title: 'Saved', description: 'All changes are live.' }, error: (err) => ({ title: 'Could not save', description: String(err) }), });
Run
Copy

Next

The toast from sileo, ported to React Native. Built in the open by rayanstudio.
© 2026 rayan · MIT License
A native port of sileo by hiaaryan