Airgap
A library of simple two-player arcade games that run entirely in the browser
with no server. Two phones exchange moves ("orders") directly, by sound
(ggwave) or by QR code. The two channels
are interchangeable, so a noisy room or a broken camera never blocks a game.
Hosted on GitHub Pages as a PWA: install it to the home screen and every page,
including the games, keeps working with no network at all.
Every game saves after each move and offers the other player's side as a QR
code, so the second phone can pick a match up mid-game by scanning it on the
Resume screen instead of starting over.
Setup
Requires Deno 2.x.
deno task setup # installs the git hooks (run once after cloning)
deno task dev # builds to dist/ and serves it at http://localhost:8443, rebuilding on change
Commands
deno task check # fmt check + lint + type check
deno task test # unit tests
deno task build # production build to dist/
deno task e2e # build, then drive the pages in headless Chromium with fake
# devices, and confirm every page still loads offline
deno task determinism # replay a game's golden checksum in Chromium, Firefox,
# and WebKit
e2e needs a Chromium (deno run -A npm:playwright install chromium);
determinism needs all three engines
(deno run -A npm:playwright install chromium firefox webkit).
The pre-commit and pre-push hooks run check and test.
Testing on phones
Open /diag.html on two devices to send a message between them by sound or QR,
or /handshake.html?role=host on one and /handshake.html?role=guest on the
other for a full call, reply and ack round. Browsers only allow the microphone
and camera on secure origins, so for local testing over Wi-Fi the dev server
needs a certificate. With mkcert:
mkdir -p .certs
mkcert -cert-file .certs/cert.pem -key-file .certs/key.pem localhost 192.168.1.10
deno task dev # now serves https on port 8443
Replace the IP with your machine's LAN address and install mkcert's root CA on
each phone. The deployed GitHub Pages site is already HTTPS.
Deploy
Pushes to main build and deploy to GitHub Pages via
.github/workflows/pages.yml.
