edgexpo CLI

Edge-Powered Development for Expo Apps with Cloudflare Workers

edgexpo transforms Expo development by hosting your app bundles on Cloudflare Workers at the edge. Each project gets its own subdomain, instant bundle serving via R2 storage, and automatic source map symbolication for error tracking. No more Metro bundler bottlenecks or localhost issues.

Built on Cloudflare's global network, edgexpo provides lightning-fast bundle delivery, built-in error monitoring with stack trace symbolication, and seamless team collaboration. Your builds are accessible from anywhere, with automatic caching and error tracking included.

/bin/bash -c "$(curl -fsSL https://edgexpo.iamolegga.com/cli/install.sh)"

What it installs

  • Node.js CLI script to ~/.local/bin/edgexpo (or /usr/local/bin if writable)
  • Latest version: v0.1.0
  • Automatic PATH configuration guidance if needed

How it Works

  • Bundle Storage: Uploads to Cloudflare R2 for global distribution
  • Edge Serving: Cloudflare Workers serve bundles with KV caching
  • Error Tracking: Real-time symbolication with source maps
  • Project Isolation: Each project gets a unique subdomain
  • Expo Compatible: Fully compatible with Expo development client

Requirements

  • Node.js (v14 or higher)
  • npx (comes with npm)
  • curl (for uploading builds)
  • zip (system zip utility)
  • Expo CLI (will be auto-installed via npx if not present)

Installation Options

Install specific version

curl -fsSL https://edgexpo.iamolegga.com/cli/install.sh | bash -s -- -v v0.1.0

Using environment variable

CLI_VERSION=v0.1.0 /bin/bash -c "$(curl -fsSL https://edgexpo.iamolegga.com/cli/install.sh)"

Usage

After installation, run from your React Native/Expo project root:

edgexpo help

Core Commands

  • edgexpo upload [ios|android] - Export, zip, and upload your app bundle to edge server
  • edgexpo run [ios|android] - Launch simulator/emulator with uploaded bundle (no local bundler)
  • edgexpo errors - Open errors page in browser to view symbolicated stack traces
  • edgexpo help - Show usage information

Workflow Example

# 1. Build and upload your app edgexpo upload ios # 2. Run on simulator without Metro bundler edgexpo run ios

The CLI automatically:

  • Runs npx expo export with optimized settings
  • Creates a compressed bundle and uploads to your Cloudflare Worker
  • Configures iOS/Android AppDelegate to fetch bundles from the edge URL
  • Saves project URL in .edgexpo-url for reuse

Error Monitoring

View runtime errors with automatic source map symbolication:

edgexpo errors

This opens your project's errors page in the browser. The Worker automatically:

  • Captures JavaScript errors from your running app
  • Symbolicates stack traces using uploaded source maps
  • Stores errors in Cloudflare D1 database
  • Provides a web UI to view the last 50 errors with full stack traces

Uninstall

To remove edgexpo CLI from your system:

rm -f ~/.local/bin/edgexpo

Or if installed globally:

rm -f /usr/local/bin/edgexpo
View Installer Script Browse Releases