Note: The public repo is 30 days behind the private development repo in order to provide a perk for patrons. This repo has active ongoing work, it just won't appear here for 30 days. If you would like to support development and get access to the latest code, please consider becoming a patron.

StarJay is a 16-bit era fantasy console with a focus on understandability. The goal is to provide the resources and interfaces required to fully understand the system and how it works, including detailed manuals, circuit schematics and a debug GUI.

Install customasm from here: https://github.com/hlorenzi/customasm

If you have rust installed, this can be as simple as:

cargo install customasm

zig build

make all
zig build test

make examples
zig build run -- --rom starjette/examples/sieve.bin --debugger

You can build a rom for assembly with:

customasm -f binary -o <rom.bin> starjette/customasm/cpudef.asm starjette/customasm/test_kernel.asm <rom.asm>

zig build run -- --rom <rom.bin> --debugger

Copyright (c) 2025 Ryan "rj45" Sanche

This project is licensed under the MIT License - see the LICENSE file for details.