https://github.com/gronxb/hot-updater
A self-hostable OTA update solution for React Native (Alternative to CodePush)
https://github.com/gronxb/hot-updater
plugin-system react-native react-native-codepush react-native-ota self-hosted supabase
Last synced: 29 days ago
JSON representation
A self-hostable OTA update solution for React Native (Alternative to CodePush)
- Host: GitHub
- URL: https://github.com/gronxb/hot-updater
- Owner: gronxb
- License: mit
- Created: 2023-10-22T15:56:45.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-13T09:06:57.000Z (30 days ago)
- Last Synced: 2025-04-13T21:19:59.317Z (29 days ago)
- Topics: plugin-system, react-native, react-native-codepush, react-native-ota, self-hosted, supabase
- Language: TypeScript
- Homepage: https://gronxb.github.io/hot-updater/
- Size: 76.3 MB
- Stars: 544
- Watchers: 5
- Forks: 41
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Hot Updater
[](https://www.npmjs.com/package/hot-updater)
A self-hostable OTA update solution for React Native **(Alternative to CodePush)**
## Documentation
Full documentation is available at:
https://gronxb.github.io/hot-updater
## Key Features
- **Self-Hosted**: Complete control over your update infrastructure
- **Multi-Platform**: Support for both iOS and Android
- **Web Console**: Intuitive update management interface
- **Plugin System**: Support for various storage providers (AWS S3, Cloudflare R2 + D1, etc.)
- **Version Control**: Robust app version management through semantic versioning
- **New Architecture**: Support for new architecture like React Native
## Plugin System
Hot Updater provides high extensibility through its plugin system. Each functionality like build, storage, and database is separated into plugins, allowing users to configure them according to their needs.
### Plugin Types
- **Build Plugin**: Support for bundlers like Metro, Re.pack
- **Storage Plugin**: Support for bundle storage like AWS S3, Supabase Storage, Cloudflare R2 Storage
- **Database Plugin**: Support for metadata storage like Supabase Database, PostgreSQL, Cloudflare D1
### Configuration Example
* [Supabase](https://gronxb.github.io/hot-updater/guide/providers/1_supabase.html)
```tsx
import { metro } from "@hot-updater/metro";
import { supabaseDatabase, supabaseStorage } from "@hot-updater/supabase";
import { defineConfig } from "hot-updater";
import "dotenv/config";
export default defineConfig({
build: metro({ enableHermes: true }),
storage: supabaseStorage({
supabaseUrl: process.env.HOT_UPDATER_SUPABASE_URL!,
supabaseAnonKey: process.env.HOT_UPDATER_SUPABASE_ANON_KEY!,
bucketName: process.env.HOT_UPDATER_SUPABASE_BUCKET_NAME!,
}),
database: supabaseDatabase({
supabaseUrl: process.env.HOT_UPDATER_SUPABASE_URL!,
supabaseAnonKey: process.env.HOT_UPDATER_SUPABASE_ANON_KEY!,
}),
});
```
* [Cloudflare](https://gronxb.github.io/hot-updater/guide/providers/2_cloudflare.html)
```tsx
import { metro } from "@hot-updater/metro";
import { d1Database, r2Storage } from "@hot-updater/cloudflare";
import { defineConfig } from "hot-updater";
import "dotenv/config";
export default defineConfig({
build: metro({ enableHermes: true }),
storage: r2Storage({
bucketName: process.env.HOT_UPDATER_CLOUDFLARE_R2_BUCKET_NAME!,
accountId: process.env.HOT_UPDATER_CLOUDFLARE_ACCOUNT_ID!,
cloudflareApiToken: process.env.HOT_UPDATER_CLOUDFLARE_API_TOKEN!,
}),
database: d1Database({
databaseId: process.env.HOT_UPDATER_CLOUDFLARE_D1_DATABASE_ID!,
accountId: process.env.HOT_UPDATER_CLOUDFLARE_ACCOUNT_ID!,
cloudflareApiToken: process.env.HOT_UPDATER_CLOUDFLARE_API_TOKEN!,
}),
});
```
* [AWS S3 + Lambda@Edge](https://gronxb.github.io/hot-updater/guide/providers/3_aws-s3-lambda-edge.html)
```tsx
import { metro } from "@hot-updater/metro";
import { s3Storage, s3Database } from "@hot-updater/aws";
import { defineConfig } from "hot-updater";
import "dotenv/config";
const options = {
bucketName: process.env.HOT_UPDATER_S3_BUCKET_NAME!,
region: process.env.HOT_UPDATER_S3_REGION!,
credentials: {
accessKeyId: process.env.HOT_UPDATER_S3_ACCESS_KEY_ID!,
secretAccessKey: process.env.HOT_UPDATER_S3_SECRET_ACCESS_KEY!,
},
};
export default defineConfig({
build: metro({ enableHermes: true }),
storage: s3Storage(options),
database: s3Database(options),
});
```