About Jeo

Jeo is a free, static-first browser-games portal hosting 570 titles across WebGL, Flash (preserved via Ruffle), and retro cartridges (emulated in-browser with EmulatorJS).

Why

Free games on the open web are a vanishing resource. Old Flash sites die when CDNs rotate; preservation copies get DMCA'd; portals stuff every page with intrusive ads. Jeo aims to be the opposite — clean, fast, no signup, no paywalls, self-hosted, and open source.

How it works

The catalog is static JSON, scanned nightly. A multi-stage pipeline (broken-game-scanner.py, build-game-health, the recovery engine) keeps the catalog honest. When a game breaks, the recovery engine searches the open web for a working copy, scrapes it with header-spoofing Puppeteer, validates against an offline manifest, and swaps it in atomically — the broken folder gets quarantined so nothing's ever half-broken.

The project

Source is on GitHub, MIT-licensed. PRs, bug reports, and game requests welcome.