alliance-sky/mgba-web

mGBA Web is a browser based emulator for classic Nintendo Game Boy, Game Boy Color, and Game Boy Advance games. It is built with React and Vite on the frontend, and it runs the mGBA emulator core through WebAssembly so the actual game logic executes at close to native speed inside the browser. You can drag in a ROM file in the gb, gbc, gba, or zip format and play it right on the page, no installation needed. The emulator includes speed controls that let you fast forward up to five times normal speed, frame skipping options, and automatic muting. For visuals, it ships several video filters, including AMD FSR 2.0 upscaling, a few crisp and smooth style filters, and a CRT style filter that mimics an old television screen. It also supports touch controls for mobile devices alongside full keyboard remapping for desktop use, and it can export and import save files and save states, syncing them automatically through the browser's IndexedDB storage. Running it locally just needs Node.js and npm, after which a single install command and a dev server command get it working at a local address. Building for production compiles everything into static files, though the build step intentionally keeps only compressed versions of the JavaScript, CSS, and WebAssembly assets to save space, which means the hosting server needs to support serving pre compressed files. Because the emulator core uses shared memory for multithreading, any server hosting the built app must send two specific security headers, Cross Origin Opener Policy and Cross Origin Embedder Policy, or the emulator will fail to load. The README gives configuration examples for Netlify, Vercel, and a self managed Nginx server with these headers included. The project credits the mGBA emulator core and its WebAssembly build, and is released under the MIT license.