Browser-on-WebKit monorepo: orchestrator, downstream WebKit (single patch tree), per-platform chrome, shared portable C++.

Platform screenshots

Each shell loads Wikipedia in Webkitium (pinned WebKit per platform). One composite image — update slots as captures land:

Platform	Status	Capture
Linux (GTK)	✅	docs/assets/screenshots/linux-wikipedia.png
Windows	pending	browser-shell-screenshots workflow
Android	pending	browser-shell-screenshots workflow
macOS	pending	browser-shell-screenshots workflow
iOS	pending	browser-shell-screenshots workflow

Regenerate the composite after adding a platform PNG:

python3 scripts/compose_platform_screenshots.py \
  --linux docs/assets/screenshots/linux-wikipedia.png \
  --windows path/to/windows.png   # optional, omit until ready

Style matches docs/assets/webkitium-banner-reference.png (monochrome frame, Zurich labels, stippled placeholders).

Layout

Area	Path
Build runner (HTTP API, jobs, logs)	orchestrator/
WebKit: all patches + per-OS scripts + deps	webkit/patches/, webkit/scripts/, webkit/deps/
Per-platform chrome / shell (source)	chrome/<platform>/
Shared C++ (sync, extensions, WebAuthn, …)	browser/
Config	config/
Docs	docs/

Rule: Patches against the WebKit checkout live under webkit/patches/. Optional extra layers live in changes/<lane>/patches/ and are off by default—see config/changes.json and changes/README.md. MiniBrowser lanes are quarantined and must not be enabled. WebGPU/Dawn work was merged into webkit/patches/windows/. WebNN/LiteRT-LM integration lives in changes/webnn-service/.

Phases, guardrails, guiding light: docs/DIRECTION.md.

Run a build

./run-build.sh windows
# canonical: webkit/scripts/common/run-build.sh

Drivers live under webkit/scripts/<os>/ (not a separate platforms/ tree).

Orchestrator: cd orchestrator && npm install && npm start — see docs/policy/RUNNER.md, orchestrator/RUNNER_API.md.

Patches and config

• Windows lane + baseline patches are one ordered series under webkit/patches/windows/ (WebGPU series first, then follow-on fixes).
• Policy and runbooks live under docs/policy/ (not scattered at repo root).
• config/build-machines.json, platforms.json, dependencies.json, .env.example describe builders, regions, and artifact layout. See config/README.md.
• config/changes.json defines optional changes/<lane>/ layers (mostly off); windows-webgpu-service stays disabled when the same work lives under webkit/patches/windows/.