React Native OTA Updater

CodePush OTA update solution for React Native applications

Overview

React Native OTA Updater is a complete solution for managing over-the-air updates for React Native applications using react-native-code-push. It provides a powerful CLI tool, web dashboard, and API server that enables mobile teams to push updates to their React Native applications without going through the app store review process.

This uses Cloudflare R2 bucket for storing bundles. You can choose your own S3 compatible storage. Make sure to update ENV variables accordingly.

You can use this article to set your Custom Host URL in react-native-code-push.

Key Features

🧑🏻‍💻 CodePush Compatible - Drop-in replacement for Microsoft CodePush
🔧 Self-Hostable - Deploy on your own infrastructure
🚀 Seamless Updates - Push JavaScript bundle updates instantly to your React Native apps
🛠️ CLI Tool - Powerful command-line interface for developers
📊 Web Dashboard - Beautiful web interface for managing apps and deployments
🔐 Authentication - Secure access with GitHub OAuth and access keys
📱 Multi-Platform - Support for both iOS and Android platforms
🔄 Deployment Management - Create and manage multiple deployment environments
📈 Analytics - Track update metrics and user adoption
📦 MonoRepo - Modular architecture with shared utilities and API client

Demo

Why Create This?

When Microsoft open-sourced their CodePush Server, it remained deeply coupled with Azure, limiting flexibility for developers who preferred alternative infrastructures. While many leveraged its permissive MIT license to build closed-source SaaS products, we envisioned something different.

This project is a modern, community-first reimagination of the original CodePush server — built with the following goals:

🧱 Modular Architecture – Clean separation of concerns with shared utilities and a robust API client
🛠️ Bring Your Own Infrastructure (BYOI) – Fully self-hostable, cloud-agnostic setup
🖥️ Intuitive Dashboard – Full control over apps, deployments, and collaborators
🧑‍💻 TypeScript First – Entire codebase written in modern, type-safe TypeScript
🔓 Truly Open Source – Licensed under GPL to ensure improvements stay in the open and benefit the community

We set out to build a fullstack, production-grade OTA update platform for React Native apps — one that respects developer freedom, encourages extensibility, and doesn’t put features behind a paywall.

Architecture

This project is built as a monorepo using Turborepo and pnpm with the following components:

CLI Tool (@rentlydev/rnota-cli) - Command-line interface for developers
Web Dashboard (@rentlydev/rnota-web) - Next.js web application
API Server (@rentlydev/rnota-api) - Hono.js REST API hosted behind Next.js API Routes
Database (@rentlydev/rnota-db) - Drizzle ORM with PostgreSQL
Authentication (@rentlydev/rnota-auth) - Auth.js integration
Shared Libraries - Common utilities and API client

Quick Start

Prerequisites

Node.js >= 22
pnpm >= 10
PostgreSQL database
Redis (for caching)

# Install Node.js via Homebrew
# You can use any other package manager like nvm, asdf, etc.
brew install node@22

# Install pnpm
brew install pnpm@10

Installation

Clone the repository

git clone https://github.com/rently-com/react-native-ota-updater.git
cd react-native-ota-updater

Install dependencies
```
pnpm install
```

Set up environment variables

cp .env.example .env
# Edit .env with your configuration

Start Database/Redis [Docker Required]

# Read the start-services.sh script for more details or modify it as per your needs
bash start-services.sh

Set up the database
```
pnpm db:push
```
Start the development servers
```
pnpm dev
```

CLI Installation (Building from Source Local)

Installation

Install dependencies
```
pnpm install
```
Build the CLI tool
```
pnpm build:cli
```
Link the CLI globally
```
pnpm link:cli
```
Verify installation
```
rnota --version
```

Updating

Pull the latest changes
```
git pull
```

Repeat Installation Steps from 1 to 4.

Uninstallation

Uninstall the CLI globally
```
pnpm remove:cli
```

CLI Installation (NPM Package)

Installation

Install dependencies
```
npm install -g @rentlydev/rnota-cli
```
Verify installation
```
rnota --version
```

Updating

Pull the latest changes
```
npm update -g @rentlydev/rnota-cli
```

Uninstallation

Uninstall the CLI globally
```
npm uninstall -g @rentlydev/rnota-cli
```

Usage

CLI Commands

Note: You can use the Handy Scripts in deploy-scripts to deploy your React Native app without typing long commands into the CLI.

Full CLI documentation is available here.

The CLI provides comprehensive commands for managing your React Native OTA updates:

Authentication

# Login with browser-based authentication
rnota login

# Choose the Environment [Local, Staging, Production]

# Login with access key
rnota login --accessKey YOUR_ACCESS_KEY

# Check current user
rnota whoami

# Logout
rnota logout

Web Dashboard

The web dashboard provides a user-friendly interface for:

App Management - Create and configure CodePush applications
Deployment Overview - Monitor deployment status and metrics
Release History - View and manage release history
Collaborator Management - Manage team access and permissions
Analytics - Track update adoption and performance metrics

Access the dashboard at http://localhost:3000 after starting the development server.
You can find the Open-API Documentation at http://localhost:3000/api/reference after starting the development server.

Configuration

React Native Integration

Old Architecture:

Tested on React Native 0.72
CodePush SDK

New Architecture:

Tested on React Native 0.76
CodePushNext SDK

Development

Modify Labels & Branding

Replace all occurrences of @rentlydev/rnota with your own organization name
Search for branding file under the web & cli packages to update the branding of the project.
Update the ADMIN_USER_EMAILS in the DB Tables to add your own admin users.

How the Database Schema is Architected?

Check out the ExcaliDraw File for more details.

Project Structure

react-native-ota-updater/
├── apps/
│   └── web/                 # Next.js web dashboard
├── deploy-scripts/          # Handy Scripts for Your React Native Project for Easier Deployment
│   └── rnotaConfig.cfg/     # Configuration file for deployment
│   └── rnotaDeploy.sh/      # Deployment script
├── docs/                    # Documentation
│   └── showcase.gif/        # Showcase GIF
├── internal/
│   ├── auth/                # Authentication module
│   └── aws/                 # AWS integration
│   ├── db/                  # Database schema and migrations
│   ├── redis/               # Redis integration
│   ├── scripts/             # Scripts for DB migrations
├── packages/
│   ├── api/                 # Hono.js API server
│   ├── cli/                 # OCLIF CLI tool
└── shared/
│   └── api-client/          # Shared API client
└── tooling/
│   └── typescript/          # Shared TypeScript config

Available Scripts

# Development
pnpm dev                    # Start all development servers
pnpm typecheck              # Run TypeScript type checking
pnpm lint:ws                # Lint all packages

# Building
pnpm build:cli              # Build CLI tool
pnpm build:next             # Build web dashboard

# Database
pnpm db:generate            # Generate database schema
pnpm db:migrate             # Run database migrations
pnpm db:studio              # Open database studio

# CLI Management
pnpm link:cli               # Link CLI globally
pnpm remove:cli             # Unlink CLI

Tech Stack

Core Technologies

Node.js >= 18 - JavaScript runtime
TypeScript - Type-safe JavaScript
pnpm - Fast, disk space efficient package manager
Turborepo - High-performance build system for monorepos

Backend

Hono - Fast, lightweight web framework
Drizzle ORM - Type-safe database toolkit
PostgreSQL - Primary database
Redis - Caching and session storage
Auth.js - Authentication framework

Frontend

Next.js 15 - React framework
Tailwind CSS - Utility-first CSS framework
Shadcn UI - Accessible component primitives
TanStack Query - Data fetching and caching

CLI

OCLIF - Open CLI Framework
Listr2 - Terminal task lists
Chalk - Terminal styling

Development Tools

Biome - Fast formatter and linter
Turbo - Build system and caching
Docker - Containerization

Contributing

We welcome contributions!

License

This project is licensed under the GPL v3 License - see the LICENSE file for details.

Acknowledgments

Standalone CodePush Server - Original inspiration

Author

@defnotsuhas

If you find this project helpful, please consider giving it a ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
.changeset		.changeset
.vscode		.vscode
apps/web		apps/web
deploy-scripts		deploy-scripts
docs		docs
internal		internal
packages		packages
shared/api-client		shared/api-client
tooling/typescript		tooling/typescript
.dockerignore		.dockerignore
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
biome.json		biome.json
docker-compose.yml		docker-compose.yml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
start-services.sh		start-services.sh
turbo.json		turbo.json

License

notsuhas/react_native_ota_updater

Folders and files

Latest commit

History

Repository files navigation

React Native OTA Updater

Overview

Key Features

Demo

Why Create This?

Architecture

Quick Start

Prerequisites

Installation

CLI Installation (Building from Source Local)

Installation

Updating

Uninstallation

CLI Installation (NPM Package)

Installation

Updating

Uninstallation

Usage

CLI Commands

Authentication

Web Dashboard

Configuration

React Native Integration

Development

Modify Labels & Branding

How the Database Schema is Architected?

Project Structure

Available Scripts

Tech Stack

Core Technologies

Backend

Frontend

CLI

Development Tools

Contributing

License

Acknowledgments

Author

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages