Side Impactor

Browser-based IPA signing and installation. Pair an iOS device over WebUSB, sign with your Apple Developer account, and install — all from a single web page.

Quick Start

bun install --ignore-scripts
bun run dev

Open http://localhost:5173.

Project Structure

Path	Purpose
`frontend/`	React + Tailwind SPA (Vite)
`backend/`	Cloudflare Workers relay
`dependencies/webmuxd/`	WebUSB usbmux/lockdown protocol library
`wasm/openssl/`	OpenSSL WASM (TLS + pair record generation)
`wasm/libcurl-wasm/`	libcurl WASM (Apple API HTTP via WISP proxy)
`wasm/zsign-wasm/`	zsign WASM (IPA re-signing)
`scripts/`	WASM native build scripts (Rust + Emscripten)

Build

# WASM dist bundles (copies pre-built src→dist, no compiler needed)
bun run build:wasm:dist

# Frontend production build (runs wasm:dist automatically)
bun run build:frontend

# Full WASM recompile from source (requires Rust, Emscripten, precompiled OpenSSL)
bun run build:wasm

Docker

bun run build:wasm:dist   # ensure WASM dists exist
docker build -t sideload-web .
docker run -p 3000:3000 sideload-web

Cloudflare

cd backend
bun run deploy

Test

bun run test            # webmuxd unit tests
bun run test:frontend   # frontend vitest suite (141 tests)

Credits

Projects referenced:

libimobiledevice
webmuxd
zsign
openssl-wasm Friends helped with feedback:
@Lakr233

1.7 KiB Raw Blame History