CHIPcade

CHIPcade is a terminal-driven 6502 fantasy console with a built-in C-to-ASM compiler.

What You Get

• 6502 VM with deterministic execution
• 256x192 4bpp bitmap display
• 16-color global palette (runtime editable)
• up to 64 hardware-style sprites
• single packaged 64 KB runtime image
• plain-text source in one place: src/
• C and ASM support in the same project
• REPL debugger (step, regs, memory, labels)
• built-in live preview window while debugging
• CLI-first workflow: scaffold, build, run, debug, package

Everything is memory-mapped: write bytes, control the machine.

Quick Start

chipcade new my_game
chipcade build my_game
chipcade run my_game

Language Options

Default scaffold is C:

chipcade new my_game

ASM scaffold:

chipcade new my_game --lang asm

You can keep both .c and .asm files in src/.

Debugging

REPL + live preview (default):

chipcade repl my_game

Terminal-only REPL:

chipcade repl my_game --no-preview

WASM

cargo install cargo-run-wasm
chipcade wasm my_game