Status & roadmap
Current status (0.1.0)
| Area | State |
|---|---|
| TypeScript API for all 23 presentation types | ✅ Implemented; 83 unit tests; typecheck clean |
Design props (appearance, styles) and behaviour props | ✅ Implemented and validated |
| Alert and toast helpers, auto-dismiss, persistent sheets, Android back button | ✅ Implemented |
| Web renderer for every placement | ✅ Implemented |
| Expo config plugin | ✅ Implemented |
| Native prop contract (codegen spec, iOS and Android setters) | ✅ Written; not yet compiled in CI |
| Native bottom sheet (iOS and Android) | ◐ Written; not yet run on a device |
| Native modal, popover, toast and other placements | ⛔ Pending: props are stored, presented as a bottom sheet |
| Example app | ◐ Written; build not yet verified |
WARNING
Treat native behaviour as a preview until the example app has been run on iOS and Android devices. Pin the exact version ("react-native-universal-sheet": "0.1.0") if you try it.
Roadmap
- Device testing of the bottom sheet on iOS and Android, including inner
ScrollViewhandoff and keyboard handling. Compile native code in CI. - Compiled build: ship JavaScript and type declarations, so web bundlers don't need to compile TypeScript from
node_modules. - Native modal presenter:
center,alert,fullScreen,popup,floating. - Side and top sheets natively.
- Overlays natively: toast, snackbar, in-app notification.
- Anchored overlays natively: popover, tooltip, context menu, dropdown, coachmark, spotlight.
- Keyboard handling driven by
enableKeyboard;hardwareBackDismisswired straight into the Android dialog. - Animation: custom springs and durations on native; reduced-motion on the web.
- Fabric component view on iOS for the New Architecture.
- Drag gestures on the web.
Want to help? See the repository's issues.