A Cross-Platform Retro gaming frontend designed for handheld and controllers. Focused on building a simple user experience and intuitive UI.
Warning
This app is actively in development, it doesn't have most of its critical features implemented yet. It will have an opinionated design and will be used as an experiment in discovering a good UX.
- Cross Platform: Can run on multiple platforms. Built with web technologies and bun backend.
- Romm Support: Has integration with romm.
- Lightweight: It uses the existing system browser to launch the front end, so no need to include a whole web browser.
- On Windows it first uses webview2 then your browser
- On linux it uses WebKitGTK or a browser even from flatpak
- Not tested on Mac yet
- Steam Deck Support: Extensively tested with the steam deck. It can use flatpak installed browsers.
- Automatic Keyboard prompts
- Great for Controllers: The UI is inspired by the switch and works great with joysticks and dpads.
- Automatic Download Downloads roms from ROMM automatically
- Automatic Emulator Discovery Using the configs of the excellent ES-DE to discover installed emulators and launch games.
- Easy fallback configuration with built in file browser.
- Responsive Layout Optimized mainly for the steam deck with responsive layout support and dynamic switching of inputs.
I want to build an open and free platform where you can play and discover new hidden gems from the past. I plan to add a free store where you can download all your needed emulators, the goal is to not have to leave the UI for anything. I really want to add matrix chat support in the app for engaging with your favorite community. Having access to so many nodejs libraries would make it quite straight forward.
-
Install dependencies:
bun install
-
Run in development mode:
# Use 'bun run dev:hmr' for hot reload bun run dev -
Build for production:
bun run build:prod
Builds will go in
/builds/<platform>. -
Additional Commands:
bun run mappings:generateconverts the es-de configs into local sqlite configs with mappings to rom systemsbun run drizzle:generategenerates sqlite migrations based on the app schemabun run openapi-tsgenerated the openapi client calls from romm's APIbun run package:windowsbuilds an package to be distributed on windowsbun run package:linuxbuilds an AppImage to be distributed on linux