{"id":30181220,"url":"https://github.com/kingstinct/react-native-activity-kit","last_synced_at":"2025-08-12T08:07:47.648Z","repository":{"id":308544952,"uuid":"1033181828","full_name":"kingstinct/react-native-activity-kit","owner":"kingstinct","description":"React Native Bindings for ActivityKit","archived":false,"fork":false,"pushed_at":"2025-08-06T14:44:25.000Z","size":646,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-06T15:08:42.267Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kingstinct.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"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},"funding":{"github":["robertherber","kingstinct"]}},"created_at":"2025-08-06T12:23:07.000Z","updated_at":"2025-08-06T14:44:10.000Z","dependencies_parsed_at":"2025-08-06T15:19:07.424Z","dependency_job_id":null,"html_url":"https://github.com/kingstinct/react-native-activity-kit","commit_stats":null,"previous_names":["kingstinct/react-native-activity-kit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kingstinct/react-native-activity-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingstinct%2Freact-native-activity-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingstinct%2Freact-native-activity-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingstinct%2Freact-native-activity-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingstinct%2Freact-native-activity-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kingstinct","download_url":"https://codeload.github.com/kingstinct/react-native-activity-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kingstinct%2Freact-native-activity-kit/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270024697,"owners_count":24514054,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"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":[],"created_at":"2025-08-12T08:07:28.106Z","updated_at":"2025-08-12T08:07:47.639Z","avatar_url":"https://github.com/kingstinct.png","language":"Swift","funding_links":["https://github.com/sponsors/robertherber","https://github.com/sponsors/kingstinct"],"categories":[],"sub_categories":[],"readme":"# @kingstinct/react-native-activity-kit\n\n[![Test Status](https://github.com/Kingstinct/react-native-activity-kit/actions/workflows/test.yml/badge.svg)](https://github.com/Kingstinct/react-native-activity-kit/actions/workflows/test.yml)\n[![Latest version on NPM](https://img.shields.io/npm/v/@kingstinct/react-native-activity-kit)](https://www.npmjs.com/package/@kingstinct/react-native-activity-kit)\n[![Downloads on NPM](https://img.shields.io/npm/dt/@kingstinct/react-native-activity-kit)](https://www.npmjs.com/package/@kingstinct/react-native-activity-kit)\n[![Discord](https://dcbadge.limes.pink/api/server/hrgnETpsJA?style=flat)](https://discord.gg/hrgnETpsJA)\n\nA powerful React Native library for iOS Live Activities using ActivityKit, built with Nitro Modules for optimal performance.\n\n## 📱 Features\n\n- **iOS Live Activities**: Create and manage live activities that appear on the lock screen and Dynamic Island\n- **Real-time Updates**: Update activity content in real-time with push notifications or local updates  \n- **TypeScript Support**: Fully typed API for enhanced developer experience\n- **Nitro Modules**: Built on Nitro for high-performance native interactions\n- **Expo Compatible**: Easy integration with Expo projects via plugin\n\n## 🚀 Installation\n\n```bash\n# npm\nnpm install @kingstinct/react-native-activity-kit\n\n# yarn  \nyarn add @kingstinct/react-native-activity-kit\n\n# bun\nbun install @kingstinct/react-native-activity-kit\n```\n\n## ⚙️ Configuration\n\n### Expo Setup\n\nAdd the plugin to your `app.json` or `app.config.js`:\n\n```json\n{\n  \"expo\": {\n    \"plugins\": [\n      \"@kingstinct/react-native-activity-kit\"\n    ]\n  }\n}\n```\n\nThe plugin automatically enables Live Activities support in your iOS Info.plist.\n\n### Manual Setup\n\nFor non-Expo projects, add this to your iOS `Info.plist`:\n\n```xml\n\u003ckey\u003eNSSupportsLiveActivities\u003c/key\u003e\n\u003ctrue/\u003e\n```\n\n## 📖 Usage\n\n```typescript\nimport { ActivityKit } from '@kingstinct/react-native-activity-kit';\n\n// Check if Live Activities are available\nif (ActivityKit.isAvailable) {\n  // Start a new activity\n  const activity = ActivityKit.startActivity(\n    // Attributes (static data)\n    { \n      title: \"Pizza Order\",\n      orderId: \"12345\"\n    },\n    // State (dynamic data)\n    {\n      status: \"preparing\",\n      estimatedTime: 15\n    },\n    // Options\n    {\n      staleDate: new Date(Date.now() + 30 * 60 * 1000), // 30 minutes\n      relevanceScore: 0.8\n    }\n  );\n\n  // Update the activity\n  activity.update({\n    status: \"ready\",\n    estimatedTime: 0\n  });\n\n  // End the activity\n  activity.end({\n    status: \"completed\"\n  });\n}\n```\n\n### Listening to Updates\n\n```typescript\n// Subscribe to activity updates\nActivityKit.subscribeToActivityUpdates((activity) =\u003e {\n  console.log('Activity updated:', activity.id, activity.activityState);\n});\n\n// Subscribe to enablement changes\nActivityKit.subscribeToActivityEnablementUpdates((enabled) =\u003e {\n  console.log('Live Activities enabled:', enabled);\n});\n```\n\n## 🏗️ Development\n\nThis is a monorepo containing:\n\n- `packages/react-native-activity-kit/`: The main library\n- `apps/activity-kit-example/`: Example Expo app demonstrating usage\n\n### Setup\n\n```bash\nbun install\n```\n\n### Development Commands\n\n```bash\n# Build the library\nbun run codegen\n\n# Lint code\nbun run lint\n\n# Type checking\nbun run typecheck\n\n# Clean build artifacts\nbun run clean:node_modules\n\n# Create a changeset for versioning\nbun run create-changeset\n```\n\n## 🛠️ Architecture\n\nBuilt on [Nitro Modules](https://github.com/mrousavy/nitro) for:\n- **High Performance**: Direct Swift/Kotlin bindings\n- **Type Safety**: Full TypeScript support\n- **Modern Architecture**: Uses the latest React Native architecture\n\n## 📱 Platform Support\n\n- ✅ iOS 16.1+ (Live Activities requirement)\n- ❌ Android (Live Activities are iOS-only)\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run tests and linting (`bun run lint \u0026\u0026 bun run typecheck`)\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to the branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## 📄 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## 🔗 Links\n\n- [GitHub Repository](https://github.com/kingstinct/react-native-activity-kit)\n- [npm Package](https://www.npmjs.com/package/@kingstinct/react-native-activity-kit)\n- [iOS ActivityKit Documentation](https://developer.apple.com/documentation/activitykit)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingstinct%2Freact-native-activity-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkingstinct%2Freact-native-activity-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkingstinct%2Freact-native-activity-kit/lists"}