reactnativecn/react-native-update is a TypeScript project with 2.0k stars in the Mobile space. π Blazing fast hot updates (OTA) for React Native β Hermes-optimized diff patches, crash rollback, staged rollout. A CodePush alternative for iOS / Android / HarmonyOS.
Snapshot summary built from the project's own GitHub metadata β there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then β see the READ ME tab for the original README in full.
react-native-update is an over-the-air (OTA) hot update library for React Native, and a maintained alternative to Microsoft CodePush (retired with App Center on March 31, 2025). It ships Hermes-optimized incremental patches (a one-line fix is about 3.4 KB), rolls back crashing updates automatically, supports staged rollouts, analytics and JS error reporting with source-mapped stacks, and runs on iOS, Android and HarmonyOS, including Expo projects and the New Architecture. For full documentation, visit:
Global service: https://cresc.dev
China service: https://pushy.reactnative.cn
React Native New Architecture is supported.
Quick Start
See the docs:
English docs: https://cresc.dev/docs/getting-started
Options reference
Every option below is declared on ClientOptions (exported from the package
root) and documented in full at https://cresc.dev/docs/api. Runtime changes go
through client.setOptions(...).
Option
Default
What it controls
appKey
required
App identity on the update platform
server
Pushy/Cresc preset
main endpoints and queryUrls for remote endpoint discovery (https only)
onAppStart / onAppResume / both / null (no automatic check; the native cold-start check still downloads but never activates)
autoMarkSuccess
true
Mark the running update healthy from the Provider
autoMarkSuccessDelayMs
1000
Delay before the automatic mark; raise it when critical modules load late
healthCheck
β
Consulted when the auto-mark timer fires; return false to keep crash protection armed
beforeCheckUpdate / afterCheckUpdate
β
Veto a check / observe its final state
beforeDownloadUpdate / afterDownloadUpdate
β
Veto a download / veto the activation after it
beforeReload
β
Veto a switchVersion / restartApp reload
onPackageExpired
β
Veto the "binary too old" flow (downloadUrl)
maxRetries
3
Download retries with jittered backoff
overridePackageVersion
β
Report a different binary version to the server
dismissErrorAfter
β
Auto-clear lastError after N ms
locale
zh (Pushy) / en (Cresc)
Language of alerts and messages
debug
false
Enable update operations in development builds and verbose SDK logging
throwError
false
Rethrow pipeline errors to the caller (they always reach onError)
disableTelemetry
false
Stop lifecycle events (download/patch failure, rollback, mark success) reaching the server
disableErrorReporting
false
Stop JS exception reporting (see below)
disableNativeCheck
false
Turn off the native cold-start check that rescues bricked devices
nativeConfigSource
'javascript'
Who owns the persisted native check configuration; 'native' when the host calls configure() itself, so JS never overwrites it (migration notes)
testChannel
true
Honour __rnPushyVersionHash deep links / QR codes; set false in production builds
logger
β
Receives every SDK event (type, data) for your own logging
Beyond the Provider hooks, the client exposes onError(listener),
captureException(error, context), resetToPackagedBundle({ restart }),
getUpdateMetadata() / attachToSentry() / attachToCrashlytics() for crash
reporters, and useUpdateProgress() for progress bars that must not re-render
the whole tree.
JS error reporting
The SDK reports uncaught and manually captured JavaScript errors against the
currently running OTA release. Reporting is enabled by default, best-effort,
disabled in development and when disableTelemetry is enabled, and never
replaces an existing React Native, Sentry or Crashlytics global handler.
You can also opt out at construction with
new Cresc({ appKey, disableErrorReporting: true }).
Only errors from an OTA version with a known version hash are uploaded. Context
is deliberately restricted to bounded scalar values; do not include secrets or
personal information.
Advantages
react-native-update provides a dedicated global service with fast and reliable worldwide delivery.
Tiny update packages generated with bsdiff/hdiff are typically only tens to hundreds of KB, instead of the tens of MB usually required by full-bundle update systems. The whole pipeline is specifically optimized for Hermes bytecode β a one-line change ships in 3.4 KB (see the comparison below), and because the newest optimizations happen at build time, apps already in the store benefit from nothing more than a rebuild.
The library tracks new React Native stable releases closely, supports Hermes bytecode, and supports the new architecture. Note: Android RN 0.73.0 to 0.76.0 new architecture is unavailable because of upstream issues; versions below 0.73 or above 0.76.1 are supported.
When updating across multiple versions, clients only need to download one update package instead of applying every intermediate version in sequence.
Command-line tools and a web dashboard are both available, making release workflows simple and CI-friendly.
The dashboard ships with built-in analytics (version distribution, update success rate), staged (gray) rollouts by percentage, and release health monitoring β no need to build your own data pipeline to keep every release under control.
Built-in crash rollback keeps updates safe and reliable, and health monitoring helps you catch and stop a bad release early.
Meta information and open APIs make the system more extensible.
An MCP server lets you connect the update service to Claude Desktop, an IDE or your own agent, ask in plain language why a device never received an update, and investigate alongside GitHub, Sentry or CI. Everything is read-only and scoped per app (Cresc docs / Pushy docs).
Native cold-start recovery: even when an update is broken badly enough that JS never runs (white screen, crash on launch), the device pulls the fixed version on its next launch from the native side β no reinstall, no app-store release (see Native cold-start check).
Paid technical support is available.
Diff Algorithm Comparison
Hermes bytecode is hostile to generic binary diffing, and we attack that at two points that stack:
Delta-mode compilation. Hermes re-sorts its string table on every compile, so a one-line JS edit renumbers most string IDs and two nearly identical bytecode files end up differing almost everywhere. bundle compiles against an earlier bytecode of the same app (hermesc -base-bytecode=β¦), pinning those IDs so that only real changes ever reach the diff.
An HBC-aware transform. Hermes bytecode is also full of offset tables, where inserting a few bytes shifts every subsequent offset. Before running hdiff we apply a delta-friendly reversible transform that delta-encodes those offset bitfields, so a global shift collapses into a single-point change. The layout description ships with each patch, so clients need zero upgrades as Hermes evolves.
The bytecode is also emitted without its debug-info section β a flat 21% smaller, the same thing React Native's own release builds do β which shrinks the full package and every patch derived from it.
The numbers below are measured on real release bundles of a React Native 0.86 app (Hermes HBC v98, ~3.5 MB bytecode with debug info stripped, as shipped). Every patch is verified by an actual round-trip before its size is recorded, and every delta-mode build is verified equivalent to a plain compile. Full methodology, fixtures, and runnable code: hbc-diff-benchmark.
Hermes bytecode (.hbc) β what ships in production Hermes apps:
Scenario
Full OTA (gzip)
bsdiff
react-native-update
vs bsdiff
One-line text change
1544.6 KB
93.7 KB
3.4 KB
28Γ smaller
Small feature (~60 LOC)
1555.8 KB
411.6 KB
50.2 KB
8.2Γ smaller
Medium feature (~300 LOC)
1604.7 KB
551.6 KB
97.8 KB
5.6Γ smaller
Plain-text JS bundle β non-Hermes apps (same scenarios, same app):
Scenario
Full OTA (gzip)
bsdiff
react-native-update
One-line text change
807.2 KB
0.3 KB
0.1 KB
Small feature (~60 LOC)
813.1 KB
7.4 KB
5.8 KB
Medium feature (~300 LOC)
837.7 KB
38.4 KB
28.7 KB
Text bundles have no offset tables and no string-table churn, so they diff cleanly on their own β patches are hundreds of bytes to tens of KB. The amplification the two optimizations above remove is a Hermes-bytecode-specific problem, which is exactly why they exist.
Highlights:
A one-line fix β by far the most common hot update β ships in 3.4 KB, 559Γ less than a full-bundle OTA.
Patch generation is 2β4Γ faster than bsdiff; the transform itself costs single-digit milliseconds.
Every stage fails safe: bounds are validated before any byte is touched, delta-mode output is checked against a plain compile, and any mismatch falls back to the previous behaviour.
Native cold-start check
Since 10.52.1 every cold start runs one background update check that does not depend on the app bundle β the request, the download, the patch and the version switch all happen natively. It exists for exactly one reason: when the running update is broken enough that JS never starts, something still has to be able to fetch the fix. Normal updates remain the JS flow's job, and the JS check reuses this result instead of issuing its own request.
It never blocks startup: delayed by a few seconds, off the main thread, effective on the next launch. Whether the downloaded version is activated automatically depends on your updateStrategy / checkStrategy; otherwise it is downloaded and JS decides.
Crash-moment rescue (Android & iOS): if the app dies of an uncaught JS error during startup, the SDK briefly holds the dying process to finish the check and download β so even a version that crashes a fraction of a second into every launch gets replaced. Crash reporters keep working: the previous handler is chained and always called afterwards. Not covered: native crashes, ANRs, OOM kills, and iOS apps that install a custom RCTSetFatalHandler.
Rescue directive: marking a version "force boot" in the dashboard activates it on the next launch regardless of the strategies above β this is how a fleet stuck on a broken version is recovered. The device-local crash-rollback guard still wins: a version this device already rolled back from is never reinstalled.
It can be turned off: disableNativeCheck: true removes one background request per cold start, at the cost of giving up the recovery above β a device bricked by a bad update can no longer heal itself.
Comparison With Other OTA Libraries
Category
react-native-update
expo-update
react-native-code-push
Price / Cost
Free tier with multiple paid plans, bandwidth included
Free tier with multiple paid plans, extra bandwidth charges apply
β Discontinued (Microsoft App Center shut down on March 31, 2025)
Package Size
βββββ Tens to hundreds of KB (incremental)
βββ Full bundle updates (usually tens of MB)
Bridge-free hosts use PushyRuntime.prepareBundle (Android),
RCTPushy.prepareBundle (Swift), or PushyFileJSBundleProvider.prepareBundle
(HarmonyOS), after normal launch bundle resolution. See the
native host API migration guide for the
source-breaking rename, unchanged JS bridge contract, and native rebuild steps.
Each platform also takes a timeout: PushyRuntime.prepareBundle(context, timeoutMillis, callback), RCTPushy.prepareBundle(timeout:completion:) and
prepareBundle(timeoutMs). On expiry the result is failed / timeout; the
round keeps running in the background and still applies to the next launch.
Without one, Android and iOS wait at most 30 minutes and HarmonyOS waits for
the round.
How active is development on reactnativecn/react-native-update?
The most recent commit recorded on reactnativecn/react-native-update was 13 days ago, based on the GitHub push timestamp. The repository has 284 forks β one of the better signals of community interest.
How many stars does reactnativecn/react-native-update have?
reactnativecn/react-native-update has 2.0k GitHub stars β refresh the page for the live number, or check github.com/reactnativecn/react-native-update. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is reactnativecn/react-native-update open source?
TopGit's metadata for reactnativecn/react-native-update does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary β verify by opening the LICENSE file directly.
What else is in the Mobile space?
reactnativecn/react-native-update is tracked by TopGit under the Mobile category, alongside 10 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is reactnativecn/react-native-update associated with?
GitHub's repository topics for reactnativecn/react-native-update: "codepush", "codepush-alternative", "expo", "harmonyos", "hermes", "hot-update", "hotfix", "ota", "over-the-air", "react-native". TopGit's editorial category is Mobile.
Where can I see reactnativecn/react-native-update in action?
The project maintains a homepage at https://cresc.dev. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about reactnativecn/react-native-update?
This TopGit page is a snapshot β the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/reactnativecn/react-native-update is the definitive source.
Read full README in the tab above.
Curious whether react-native-update is right for you?
Let ChatGPT, Claude, or Perplexity look into it β click below and see what AI actually says about react-native-update.