Skip to main content
Home/versions/latest
Latest stable docs

Expo Draw Over Apps

SDK 56 keeps the Android overlay API and adds close helpers, native shared values, and animated window container APIs.

Reference version
SDK 56
Bundled version
56.0.6
Platform
Android

Installation

npm install expo-draw-over-apps@56.0.6
npx expo install react-native-reanimated react-native-worklets

Features

Core overlay API

  • Android draw-over-apps permission helpers.
  • Floating bubble overlay with visibility state.
  • React Native and Jetpack Compose renderer registration.

New in SDK 56

  • FloatingWindowPreview for rendering a bubble fixture inside the app before starting the overlay service.
  • Edge hide controls for tucking a bubble against the screen edge.
  • Close helpers that release overlay surfaces instead of leaving windows mounted.
  • Native-backed numeric shared values for counters and window state that need to survive app backgrounding.
  • ReactNativeWindowContainer for Reanimated width, height, and radius transitions.
  • NativeWindowContainer for an Expo UI Android Host/Surface backdrop with React Native children and system light/dark defaults.

API surface

  • canDrawOverlays and requestPermission
  • showBubble, closeBubble, closeAllBubbles, and isBubbleVisible
  • setBubbleRenderer, setBubbleRendererForBubble, and setComposeBubbleRenderer
  • useBubbleState, useAllBubbleStates, and subscribeToBubbleState
  • setOverlaySharedValue, useOverlaySharedValueState, and refreshAllOverlaySharedValueStates
  • getOverlaySharedValueState, useAllOverlaySharedValueStates, and normalizeOverlaySharedValueKey
  • FloatingWindowPreview
  • setEdgeHideEnabled
  • ReactNativeWindowContainer
  • NativeWindowContainer