A Forth-based Game Boy development kit
It features a Forth-based assembler, a cross-compiler with support for lazy code generation and a library of useful words.
The best way to contribute would be try to write a game! Then we can, at the same time, improve gbforth to make it more useful.
For more detailed guidelines read the contribution guide.
Also have a look to the issues in GitHub:
brew install gforth
To build the examples, run
To run the tests, you need to have
yarn installed. Make
sure to install the dependencies in the
test/ directory first:
( cd test/; yarn )
After that you can run the tests:
Running with Docker
You can run gbforth in Docker using the amshackers/gbforth image:
docker run amshackers/gbforth
To compile your project, mount your project directory as a volume and pass the input and output file as CLI arguments:
docker run --rm -v "$PWD":/data amshackers/gbforth game.fs game.gb