{"id":50103148,"url":"https://github.com/callstackincubator/voltra","last_synced_at":"2026-06-13T19:35:15.044Z","repository":{"id":332519805,"uuid":"1107515227","full_name":"callstackincubator/voltra","owner":"callstackincubator","description":"Voltra lets React Native developers build native iOS Live Activities, Dynamic Island layouts, and widgets as React components without writing Swift. It supports hot reload, push updates, and includes a config plugin that wires everything automatically.","archived":false,"fork":false,"pushed_at":"2026-06-12T14:53:29.000Z","size":10044,"stargazers_count":757,"open_issues_count":25,"forks_count":37,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-06-13T19:35:11.684Z","etag":null,"topics":["ios","live-activity","react-native","widget"],"latest_commit_sha":null,"homepage":"https://use-voltra.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/callstackincubator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-01T08:46:06.000Z","updated_at":"2026-06-13T04:08:25.000Z","dependencies_parsed_at":"2026-05-26T14:04:55.568Z","dependency_job_id":null,"html_url":"https://github.com/callstackincubator/voltra","commit_stats":null,"previous_names":["callstackincubator/voltra"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/callstackincubator/voltra","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstackincubator%2Fvoltra","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstackincubator%2Fvoltra/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstackincubator%2Fvoltra/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstackincubator%2Fvoltra/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/callstackincubator","download_url":"https://codeload.github.com/callstackincubator/voltra/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/callstackincubator%2Fvoltra/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34298247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ios","live-activity","react-native","widget"],"created_at":"2026-05-23T09:00:21.140Z","updated_at":"2026-06-13T19:35:15.026Z","avatar_url":"https://github.com/callstackincubator.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"![voltra-banner](https://use-voltra.dev/voltra-baner.jpg)\n\n### Build Live Activities and Widgets with JSX in React Native\n\n[![mit licence][license-badge]][license] [![npm downloads][npm-downloads-badge]][npm-downloads] [![PRs Welcome][prs-welcome-badge]][prs-welcome]\n\nVoltra turns React Native JSX into SwiftUI and Jetpack Compose Glance so you can ship custom Live Activities, Dynamic Island layouts, and Android Widgets without touching native code. Author everything in React, keep hot reload, and let the config plugin handle the native extension targets.\n\n## Features\n\n- **Ship Native Surfaces**: Create iOS Live Activities, Dynamic Island variants, and Android Home Screen widgets directly from React components - no Swift, Kotlin, or Xcode/Android Studio UI work required.\n\n- **Fast Development Workflow**: Hooks respect Fast Refresh and both JS and native layers enforce platform-specific payload budgets.\n\n- **Production-Ready Push Notifications**: Support for ActivityKit push tokens (iOS) and FCM (Android) to stream lifecycle updates and build server-driven refreshes.\n\n- **Familiar Styling**: Use React Native style props and platform-native modifiers (SwiftUI/Glance) in one place.\n\n- **Type-Safe \u0026 Developer-Friendly**: The Voltra schema, hooks, and examples ship with TypeScript definitions, tests, and docs so AI coding agents stay productive.\n\n- **Works With Your Setup**: Compatible with Expo Dev Client and bare React Native projects. Platform config plugins wire native extension targets for you.\n\n## Documentation\n\nThe documentation is available at [use-voltra.dev](https://use-voltra.dev). You can also use the following links to jump to specific topics:\n\n- [Getting Started](https://use-voltra.dev/getting-started/introduction)\n- [Installation](https://use-voltra.dev/getting-started/installation)\n- [iOS Setup](https://use-voltra.dev/ios/setup)\n- [Android Setup](https://use-voltra.dev/android/setup)\n- [iOS Development](https://use-voltra.dev/ios/development/developing-live-activities)\n- [Android Development](https://use-voltra.dev/android/development/developing-widgets)\n- [iOS API Reference](https://use-voltra.dev/ios/api/configuration)\n- [Android API Reference](https://use-voltra.dev/android/api/plugin-configuration)\n\n## Getting started\n\n\u003e [!NOTE]\n\u003e The library isn't supported in Expo Go. To set it up correctly, you need to use [Expo Dev Client](https://docs.expo.dev/versions/latest/sdk/dev-client/).\n\nInstall the client package for each platform you need:\n\n```sh\n# iOS\nnpm install @use-voltra/ios-client\n\n# Android\nnpm install @use-voltra/android-client\n```\n\nAdd the Expo plugins to your `app.json`:\n\n```json\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"@use-voltra/ios-client\",\n        {\n          \"groupIdentifier\": \"group.your.bundle.identifier\",\n          \"enablePushNotifications\": true\n        }\n      ],\n      [\n        \"@use-voltra/android-client\",\n        {\n          \"widgets\": [\n            {\n              \"id\": \"my_widget\",\n              \"displayName\": \"My Widget\",\n              \"description\": \"A Voltra widget\",\n              \"targetCellWidth\": 2,\n              \"targetCellHeight\": 2\n            }\n          ]\n        }\n      ]\n    ]\n  }\n}\n```\n\nThen run `npx expo prebuild --clean` to generate the native extension targets.\n\nSee the [documentation](https://use-voltra.dev/getting-started/installation) for detailed setup instructions.\n\n## Quick example\n\n```tsx\nimport { useLiveActivity, Voltra } from '@use-voltra/ios-client'\n\nexport function OrderTracker({ orderId }: { orderId: string }) {\n  const ui = (\n    \u003cVoltra.VStack style={{ padding: 16, borderRadius: 14, backgroundColor: '#111827' }}\u003e\n      \u003cVoltra.Text style={{ color: 'white', fontSize: 18, fontWeight: '700' }}\u003eOrder #{orderId}\u003c/Voltra.Text\u003e\n      \u003cVoltra.Text style={{ color: '#9CA3AF', marginTop: 6 }}\u003eDriver en route · ETA 12 min\u003c/Voltra.Text\u003e\n    \u003c/Voltra.VStack\u003e\n  )\n\n  const { start, update, end } = useLiveActivity(\n    { lockScreen: ui },\n    {\n      activityName: `order-${orderId}`,\n      autoStart: true,\n      deepLinkUrl: `/orders/${orderId}`,\n    }\n  )\n\n  return null\n}\n```\n\n## Platform compatibility\n\nVoltra is a cross-platform library that supports:\n\n- **iOS**: Live Activities and Dynamic Island (SwiftUI).\n- **Android**: Home Screen Widgets (Jetpack Compose Glance).\n\n## Authors\n\nVoltra is an open source collaboration between [Saúl Sharma](https://github.com/saulsharma) and [Szymon Chmal](https://github.com/szymonchmal) at [Callstack][callstack-readme-with-love].\n\nIf you think it's cool, please star it 🌟. This project will always remain free to use.\n\n[Callstack][callstack-readme-with-love] is a group of React and React Native geeks, contact us at [hello@callstack.com](mailto:hello@callstack.com) if you need any help with these or just want to say hi!\n\nLike the project? ⚛️ [Join the Callstack team](https://callstack.com/careers/?utm_campaign=Senior_RN\u0026utm_source=github\u0026utm_medium=readme) who does amazing stuff for clients and drives React Native Open Source! 🔥\n\n[callstack-readme-with-love]: https://callstack.com/?utm_source=github.com\u0026utm_medium=referral\u0026utm_campaign=voltra\u0026utm_term=readme-with-love\n[license-badge]: https://img.shields.io/npm/l/@use-voltra/ios?style=for-the-badge\n[license]: https://github.com/callstackincubator/voltra/blob/main/LICENSE.txt\n[npm-downloads-badge]: https://img.shields.io/npm/dm/@use-voltra/ios-client?style=for-the-badge\n[npm-downloads]: https://www.npmjs.com/package/@use-voltra/ios-client\n[prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge\n[prs-welcome]: ./CONTRIBUTING.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallstackincubator%2Fvoltra","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcallstackincubator%2Fvoltra","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcallstackincubator%2Fvoltra/lists"}