GB Studio is a cross-platform desktop application for creating retro Game Boy games using a visual, drag-and-drop interface. It’s designed for beginners with no programming experience but also allows advanced users to access the underlying GBDK C engine and GBVM virtual machine. The tool enables users to build top-down, platformer, and shooter games with custom logic, music, and assets—all without touching code.
Built with Electron and powered by GBDK (Game Boy Development Kit) and GBVM, GB Studio generates real Game Boy ROMs, web builds, and Pocket format files. It supports plugin extensions, CLI automation for exports, and integrates with external tools like hUGETracker. Users can deploy games to Itch.io, emulate on real hardware, or share web versions with mobile controls.
What You Get
- Visual Scripting - Drag-and-drop event system to create game logic without writing code, using conditionals, actions, and triggers for characters, objects, and scenes.
- Built-in Music Editor - Create chiptune music with both piano roll and tracker interfaces, and import/export tracks from external tools like hUGETracker.
- ROM Export - Generate real Game Boy ROM (.gb) files compatible with emulators and physical Game Boy hardware.
- Web Export - Build playable HTML5 versions of your game with optimized mobile touch controls for publishing on Itch.io or other platforms.
- Pocket Format Support - Export games in .pocket format for the Pocket CHIP and other handheld devices running the Pocket OS.
- CLI Automation - Use command-line tools to export projects, generate ROMs, or build web versions programmatically via gb-studio-cli for CI/CD pipelines.
- Debugger - Built-in visual debugger to inspect game state, event triggers, and variable values during development for troubleshooting complex logic.
- Plugin System - Extend functionality by writing custom plugins that interact with the GBDK C engine or modify GBVM behavior using JavaScript.
Common Use Cases
- Teaching kids game design - Parents and educators use GB Studio to introduce children to game logic and programming concepts through visual scripting and pixel art.
- Developing indie Game Boy games - Indie developers create full commercial titles with custom stories, music, and mechanics, then release them on physical cartridges or Itch.io.
- Retro game jams - Developers build playable Game Boy games in under a week for events like Bored Pixels, using GB Studio’s rapid prototyping tools.
- Creating branded microgames - Companies like McDonald’s and Nike use GB Studio to produce simple, nostalgic promotional games for marketing campaigns.
Under The Hood
Architecture
- Follows a clean layered architecture with distinct separation between UI, state management, and low-level engine logic, leveraging React and Redux Toolkit for predictable state flow
- Implements a plugin-like event compilation system using compile-time registration to enable extensible visual scripting without runtime reflection
- Enforces modular boundaries through path aliases and strict TypeScript configuration, with clear separation of concerns between core engine, tooling, and UI components
- Uses WASM-based Game Boy VM emulation to isolate hardware-level operations while maintaining high-level tooling in the main application layer
Tech Stack
- Built on Electron with React 18 and TypeScript, using Webpack and Electron Forge for robust desktop packaging and distribution
- Employs Redux Toolkit for cross-process state management, with ESLint enforcing process boundaries between main and renderer threads
- Integrates QuickJS via Emscripten to run Game Boy game logic in-browser, complemented by media encoding libraries for audio and asset handling
- Leverages Jest for comprehensive testing, Storybook for component documentation, and Knip for dead code detection in a modern build pipeline
Code Quality
- Highly typed with TypeScript interfaces and type guards, ensuring robustness across event compilation, utilities, and UI components
- Consistent and descriptive naming conventions distinguish between UI identifiers and low-level VM operations, improving readability
- Extensive test coverage for core systems like event handlers and scripting logic, though some edge cases lack implementation
- Minimal error handling and absence of structured logging create opaque failure modes in complex workflows like script compilation
What Makes It Unique
- Seamlessly integrates Game Boy hardware constraints into the editor’s UI and scripting system, enabling real-time validation against platform limits
- Features a declarative event scripting system that auto-generates assembly-level compilation logic, bridging visual design with native VM execution
- Implements a dynamic theme system that allows community contributions to override UI elements without modifying core code
- Includes domain-specific event hooks for adventure game mechanics and a built-in piano roll editor that simulates Game Boy sound chip behavior in real time