Awesome
VaporBoy
<!-- Badges -->An A E S T H E T I C GB / GBC Emulator PWA. Powered by wasmBoy.
Talk given at WebAssembly SF March 28th, 2019
Table of Contents
- Features
- Example Gifs & Screenshots
- Lighthouse Score
- Contributing
- Special Thanks
- Other Notes & Links
- Privacy
Features
-
Emulates the Gameboy / Gameboy Color using wasmBoy, for Web Assembly awesome-ness. đŽđžđšī¸
-
Built as a Progressive Web App(PWA), using Preact. âī¸
-
Feel all of the VaporWave N O S T A L G I A, and appreciate the A E S T H E T I C of aesthetic-css. đŧđ
-
Upload your ROMs from anywhere. Local Device, Pre-loaded Open Source ROMS, and even cloud services! đēâī¸
-
Unique layouts for portrait (GBC), landscape (GBA), and desktop (SGB). đąđĨī¸
-
Keyboard, touch, and gamepad input support using responsive gamepad. â¨ī¸ đŽ
-
Supports all major browsers (Chrome, Firefox, Safari). Meaning, you can play gameboy on your iPhone! đ
-
Installable using Desktop PWA Support and Mobile Browser's Add to Homescreen. đĨī¸đą
-
Have complete control of your emulation and performance with configurable settings and save states. âī¸đž
-
Experience the gameboy like you never have before, with Video/Audio altering VaporBoy effects. đđđš
Example Gifs & Screenshots
<img alt="Desktop Layout" src="./readme_assets/desktopLayout.png" width="300px"/> <img alt="Land Scape Layout" src="./readme_assets/landscapeLayout.png" width="300px"/> <img alt="Desktop Control Panel" src="./readme_assets/desktopControlPanel.png" width="300px"/> <img alt="Land Scape Settings" src="./readme_assets/landscapeSettings.png" width="300px"/>
<img alt="Portrait Layout" src="./readme_assets/portraitLayout.png" height="300px"/> <img alt="Portrait ROM source Selector" src="./readme_assets/portraitROMSourceSelector.png" height="300px"/> <img alt="Portrait Home brew ROMs" src="./readme_assets/portraitHomebrewROMs.png" height="300px"/> <img alt="Portrait Effects" src="./readme_assets/portraitEffects.png" height="300px"/> <img alt="Portrait Tobu Tobu Girl" src="./readme_assets/portraitTobu.png" height="300px"/>
Lighthouse Score
Contributing
Feel free to fork and submit PRs! Any help is much appreciated, and would be a ton of fun! I would appreciate opening an issue, or replying to an already open issue to express intent of trying to solve the issue, and we discuss.
Installation
Just your standard node app. Install Node with nvm, git clone
the project, and npm install
, and you should be good to go!
Npm Scripts & CLI Commands
# Starts the preact development server.
npm run start
# Same as `npm run start`
npm run dev
# Runs all precommit hooks
npm run precommit
# Runs the prettier linter, and automagically fixes all linting errors
npm run prettier:fix
# Builds a production version of the PWA
npm run preact:build
# Watches for changes, and continually builds/servers a production version of the PWA
npm run preact:build:watch
# Serves the locally built PWA
npm run preact:serve
# Serves the preact development server, called by `npm run start`
npm run preact:dev
# Start the cordova browser platform for development
npm run cordova:serve
# Serves the cordova (mobile) development server
npm run cordova:dev
# Start the electron server
npm run electron:serve
# Start the electron development server
npm run electron:dev
Special Thanks
-
Leah Rose Garza, Artist of the Vaporboy Logo.
-
awesome gb-dev communitty, too many rad dudes to name!
-
dcodeIO for building and fixing bugs with AssemblyScript. And for being awesome!
-
r/emudev, especially to binjimint for helping me sooooo much!
Other Notes & Links
Privacy
Analytics is used on this application simply for performance monitoring, and tracking popularity of the applications. The following events are sent, with nothing more than the event name. The analytics provider used is Google Analytics.
The Events sent are:
- Save State Created
- Homebrew ROM Loaded
- My Collection ROM Loaded
- Scraper opened
- Manual reload
- Settings Applied
- Install opened
- Scraper skipped
- Scraper Search
- About Opened
- Scaper Manual Input
- Settings reset
- Google Drive ROM Load