Delivr

Mobile DevOps Platform · Self-Hosted · Open Source

delivr.live

What is Delivr?

A distribution platform that simplifies how teams build, test, and release mobile apps through automated operations, integration with multiple channels and distribution analytics.

Platform Architecture:

┌─────────────────────────────────────────────────┐
│         Delivr Mobile DevOps Platform          │
├─────────────────────────────────────────────────┤
│  Build Orchestration  │  Release Management    │
│   (Coming Soon)       │   (Coming Soon)        │
│   Any Mobile App      │   Any Mobile App       │
├─────────────────────────────────────────────────┤
│      Over-the-Air Updates (Available Now)      │
│            React Native                         │
└─────────────────────────────────────────────────┘

Available Now: - Over-the-Air Updates for React Native apps - Deploy JavaScript and asset updates instantly without app store approval

Coming Soon: - Build Orchestration for all mobile apps - Automated builds for iOS and Android - Release Management for all mobile apps - Coordinate store and OTA releases with approval workflows

Why Delivr?

🚀 Accelerated Velocity - Deploy updates in minutes instead of days - Iterate rapidly without app store bottlenecks - Ship fixes immediately when they matter most

🏗️ Full Control - Self-host on your infrastructure - Complete data ownership - No third-party processing

🔌 Flexible & Extensible - Plugin architecture for storage, database, auth - Open source and customizable - API-first design

📊 Unified Platform - Single dashboard for updates (now) + builds & releases (soon) - Consistent experience across teams - Reduced tool sprawl

🔒 Security & Compliance - Self-hosted means your data stays yours - Code signing for verified updates - Audit trails and access control

⚡ Battle-Tested - Production-proven in high-scale environments - Handles high request volumes with proper infrastructure - Designed for large user bases

Quick Start

Prerequisites: Docker Desktop (running), Node.js 18+

# 1. Clone this monorepo
git clone https://github.com/ds-horizon/delivr.git
cd delivr

# 2. Launch all services
chmod +x launch_script.sh
./launch_script.sh

The script will guide you through: - ✅ Environment setup and validation - ✅ Port conflict resolution - ✅ Starting all services (API, Dashboard, Database, Cache)

Access: - Dashboard: http://localhost:3000 - API Server: http://localhost:3010

→ Complete setup guide: delivr.live/dota/full-setup

What's Available

✅ Production Ready (Available Now)

Pillar 1: Over-the-Air Updates - ✅ Instant Deployment - Push JS/asset updates in minutes, not days - ✅ Delta Patching - Significantly smaller downloads with binary diffs - ✅ Staged Rollouts - Gradual releases with percentage control - ✅ Mandatory Updates - Force critical fixes immediately - ✅ Automatic Rollback - SDK auto-reverts crashes - ✅ Version Targeting - Deploy to specific app versions (semver) - ✅ Multi-Deployment - Separate staging and production environments - ✅ Code Signing - Cryptographic verification of updates - ✅ Brotli Compression - Additional size reduction on bundles - ✅ Base Bytecode Optimization - Hermes bytecode for smaller patches

Web Dashboard - ✅ App Management - Create and manage multiple apps - ✅ Deployment Control - Manage staging and production deployments - ✅ Release History - Track all deployed versions - ✅ Real-Time Analytics - Monitor adoption, versions, and errors - ✅ Rollout Control - Adjust rollout percentages on the fly - ✅ OAuth Authentication - Google, GitHub, Microsoft login

CLI Tool - ✅ Automated Releases - CI/CD-friendly deployment commands - ✅ Binary Patching - Create efficient patch bundles - ✅ Release Management - Promote, rollback, and clear releases - ✅ Debug Tools - Troubleshoot deployments and SDK integration - ✅ Code Signing - Sign releases for security

Infrastructure & Platform - ✅ Self-Hosted - Deploy on your infrastructure - ✅ Plugin System - Pluggable storage (S3/Azure/Local), database (MySQL/Postgres), auth - ✅ Multi-Cloud - AWS, Azure, or on-premises deployment - ✅ Docker-First - Complete Docker Compose setup included - ✅ CDN Support - CloudFront and Azure CDN integration - ✅ Caching - Multi-layer Redis and Memcached - ✅ Health Checks - Monitoring and status endpoints - ✅ Battle-Tested - Production-proven at scale - ✅ API Versioning - Legacy and modern API support

🔜 In Development (Coming Soon)

Pillar 2: Release Management - 🔜 Approval Workflows - Multi-stage approval gates for release governance - 🔜 Release Coordination - Sync App Store, Play Store, and OTA releases - 🔜 Release Trains - Scheduled, predictable release cycles - 🔜 Automated Guardrails - Auto-rollback on error thresholds - 🔜 Store Integration - Track App Store and Play Store submission status

Pillar 3: Build Orchestration - 🔜 Git Integration - Webhook-triggered builds from repository - 🔜 Multi-Platform Builds - iOS and Android from single source - 🔜 Real-Time Logs - Stream build logs to dashboard - 🔜 Artifact Management - Store and manage build artifacts - 🔜 CI/CD Integration - Jenkins, CircleCI, GitHub Actions support

Platform Enhancements - 🔜 GCP Deployment - Google Cloud Platform support - 🔜 Expo Plugin - First-class Expo integration - 🔜 Device Testing - Cloud-based device farms for QA - 🔜 Advanced Analytics - Enhanced insights and metrics

Use Cases

OTA Updates for React Native (Available Now): - Instant Bug Fixes - Deploy critical fixes without app store review - Security Patches - Patch vulnerabilities immediately - Feature Flags - Enable/disable features remotely - A/B Testing - Test variants with different user segments - Regional Rollouts - Launch features in specific regions first - Rapid Iteration - Deploy updates multiple times per day

Build & Release for All Mobile Apps (Coming Soon): - Automated Build Pipelines - Git push triggers iOS and Android builds - Coordinated Releases - Sync App Store and Play Store submissions - Release Management - Multi-stage approvals and automated guardrails - Works with any framework - Native, React Native, Flutter, Ionic, etc.

How OTA Updates Work

For React Native apps:

1. App Release
   React Native app with Delivr SDK → Published to App Store/Play Store

2. Update Creation
   Developer creates update → Via Web Dashboard or CLI

3. Bundle Storage
   Update bundle stored → Your infrastructure (S3, Azure Blob, etc.)

4. Update Check
   Mobile app checks for updates → Delivr Backend API

5. Download & Apply
   SDK downloads and applies → JavaScript/asset updates instantly

What Can Be Updated via OTA?

✅ No Store Review Required: - JavaScript & TypeScript code - React components and UI - Images and assets - JSON configuration - Styling and themes

❌ Requires App Store Submission: - Native code (Swift, Java, Kotlin, Objective-C) - Native modules and dependencies - App permissions - App icons and launch screens

Complete list of supported components

Future Expansion: Build Orchestration and Release Management will support all mobile apps (iOS and Android) regardless of framework - native apps, React Native, Flutter, Ionic, or any other framework.

Monorepo Structure

This repository contains all Delivr components:

Deployment Options

App Store Compliance

✅ OTA updates comply with Apple and Google guidelines:

Requirements: - JavaScript and assets only (no native code) - Cannot change app's primary purpose - Updates must be transparent to users

Full compliance guide: Store Guidelines

Performance

OTA Updates: - Update checks are fast with multi-layer caching - Download times depend on patch size and network conditions - Patch application is near-instantaneous

Efficiency: - Delta patches significantly reduce download sizes - Brotli compression provides additional size reduction - Typical result: Small patch bundles for incremental updates

Scale: - Battle-tested in production environments - Handles high request volumes with proper infrastructure - Multi-region CDN distribution supported

Documentation

Getting Started

• Complete Setup Guide - End-to-end setup from installation to first deployment

SDK Integration

• Delivr SDK Overview
• iOS Setup Guide
• Android Setup Guide
• JavaScript API Reference
• How OTA Updates Work
• Multi-Deployment Testing
• Store Guidelines

CLI Usage

• CLI Overview
• CLI Command Reference
• Binary Patching (bsdiff)

Server & Infrastructure

• Server Overview
• Development Setup
• Environment Configuration
• Architecture Details

Web Dashboard

• Web Panel Overview

Community & Support

• GitHub Issues → Report bugs & request features
• GitHub Discussions → Ask questions
• Website → delivr.live

Contributing

We welcome contributions! Each component has its own contributing guide:

• CLI Contributing
• SDK Contributing
• Server Contributing

License

MIT License - see LICENSE.txt

Security

Report security vulnerabilities: SECURITY.md

Made with ❤️ by Dream Horizon

Get Started · Documentation