yuanzhe1999/SideImpactor

mirror of https://github.com/lbr77/SideImpactor.git synced 2026-05-06 11:14:01 -04:00

Files

Lakr afec333aa0 refactor: migrate frontend to React + Tailwind, add Docker + tests

Replace the vanilla-TS innerHTML frontend with a type-checked React
component tree (React 19 + Tailwind v4 + Vite).

Frontend:
- 14 components: Header, Stepper, LoginPage, LoginModal, SignPage,
  DropZone, DevicePicker, ProgressCard, SavedAccountsList, TrustModal,
  TwoFactorModal, Button, Field, Chip, Modal
- lib/ extracts: storage (10 localStorage keys preserved), pair-record,
  account-session, log-parser, ids, use-log hook
- flows/ encapsulate async pair/login/sign/install with dependency injection
- Accounts page as main view with Add Account modal
- Fullscreen progress overlay during sign/install
- Account selector + device picker on Sign page
- Security notice in login modal (server trust warning)
- All addLog calls mirrored to console.log for devtools debugging

Build:
- bun run dev: submodule init + install + wasm dist + vite + wrangler
- bun run setup: one-shot project bootstrap
- Docker: multi-stage bun build → nginx on :3000
- build:wasm:dist copies pre-built src→dist (no Rust/Emscripten needed)
- jszip/node-forge/fflate pre-bundled for CJS→ESM conversion

Tests:
- 163 vitest tests (happy-dom): all lib, components, App integration,
  WASM dist artifact checks, libcurl Apple connectivity, anisette init
  error handling

Cleanup:
- Delete yarn.lock (bun.lock canonical), expand .gitignore
- Remove README.zh.md, rewrite README.md + AGENTS.md
- Update libcurl.js submodule to f65d440 (CI build artifacts)

2026-04-13 17:02:45 +08:00

1.5 KiB

Raw Blame History

Sideload.js

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

Test

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

1.5 KiB Raw Blame History