• v2

      • 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

      iOS (Live Activities and widgets)

      npm
      yarn
      pnpm
      bun
      deno
      npm install @use-voltra/ios @use-voltra/ios-client

      Android (Home Screen widgets and ongoing notifications)

      npm
      yarn
      pnpm
      bun
      deno
      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)

      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

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

      Need React or React Native expertise you can count on?

      Let's talk