Skip to content
Voltraby Callstack

Installation

Voltra v2 ships as platform packages. In most apps, you install one package for JSX primitives and one package for runtime APIs per platform.

1. Install packages

Section titled “1. Install packages”

iOS (Live Activities and widgets)

Section titled “iOS (Live Activities and widgets)”
Terminal window
npm install @use-voltra/ios @use-voltra/ios-client

Android (Home Screen widgets and ongoing notifications)

Section titled “Android (Home Screen widgets and ongoing notifications)”
Terminal window
npm install @use-voltra/android @use-voltra/android-client

Use the platform package for JSX primitives:

  • @use-voltra/ios exports Voltra
  • @use-voltra/android exports VoltraAndroid, AndroidDynamicColors, and AndroidOngoingNotification

Use the client package for React Native runtime APIs:

  • @use-voltra/ios-client exports startLiveActivity, updateWidget, VoltraView, VoltraWidgetPreview, and other app-side APIs
  • @use-voltra/android-client exports updateAndroidWidget, requestPinAndroidWidget, reloadAndroidWidgets, VoltraView, VoltraWidgetPreview, and other app-side APIs

Server rendering (optional)

Section titled “Server rendering (optional)”

Use these in your backend or SSR service-not in the React Native app bundle:

  • iOS payloads: @use-voltra/ios-server
  • Android payloads: @use-voltra/android-server
  • Cross-platform widget HTTP handlers: @use-voltra/server

Note that pre-render files such as initialStatePath should import JSX from @use-voltra/ios or @use-voltra/android directly, not from the client packages.

2. Next Steps

Section titled “2. Next Steps”

After installing packages, configure the Voltra Expo plugin for each platform you support:

© 2026 Voltra by Callstack