Introduction
Pecten is a browser-first Game Boy Advance emulator built with Rust and WebAssembly. The project is organized around a clean boundary: the emulator logic lives in Rust, while the app shell is delivered through a modern web stack.
This section is for contributors. To play games, see the User Manual.
Goals
The project aims to:
- run a GBA emulator in a browser using WebAssembly
- keep the emulator core deterministic and testable
- separate browser glue from the emulator logic
- support responsive UI and installable PWA behavior
- document the architecture in a static docs site hosted through GitHub Pages
Current status
The core runs the jsmolka/gba-tests ARM, Thumb, and memory suites and boots cartridges through a high-level-emulated BIOS (HLE BIOS). It renders all display modes, plays PSG and DirectSound audio, and emulates SRAM, Flash, and EEPROM saves. The browser shell adds a ROM library, save states, keyboard and touch input, and PWA installation.
Not yet implemented: memory wait states and the prefetch buffer, serial and link hardware, and several BIOS services. Accuracy varies by game.
Recommended workflow
- Implement one emulator subsystem at a time in Rust
- Add failing tests before broad feature logic
- Expose only the minimal wasm boundary needed by the app
- Validate the browser shell separately from emulator correctness
See Development Workflow for the commands.
