Monorepo for Aesthetic.Computer
aesthetic.computer
1# KidLisp GameBoy - Quick Reference
2
3## 🎮 Current Status
4✅ Working Bresenham line drawing in `test/line-demo.asm`
5
6## 🔨 Build & Run Workflow
7
8### 1. Build a ROM
9```bash
10cd /workspaces/aesthetic-computer/kidlisp-gameboy
11fish build.fish line-demo
12```
13
14### 2. Load in Browser
15```bash
16ac-run gameboy~line-demo
17```
18
19### 3. Watch Mode (auto-rebuild on save)
20```bash
21cd /workspaces/aesthetic-computer/kidlisp-gameboy
22fish watch-build.fish line-demo
23```
24Edit `test/line-demo.asm`, save, and it rebuilds automatically.
25Then reload with `ac-run gameboy~line-demo`
26
27## 📁 Available ROMs
28
29See all available test ROMs:
30```bash
31ls test/*.asm | sed 's/test\///' | sed 's/\.asm$//'
32```
33
34Popular ones:
35- `line-demo` - Bresenham X pattern ⭐
36- `ascii-scroll` - Scrolling text
37- `bounce-ball` - Bouncing ball physics
38- `starfield` - Animated stars
39- `typewriter` - Text effect
40
41## 🧪 Development Loop
42
431. **Edit** assembly in `test/<rom-name>.asm`
442. **Build** with `fish build.fish <rom-name>`
453. **Run** with `ac-run gameboy~<rom-name>`
464. Repeat!
47
48Or use watch mode to skip step 2.
49
50## 📚 Docs
51- `BRESENHAM-SUCCESS.md` - How line drawing works
52- `PROGRESS.md` - Full development history
53- `WORKFLOW.md` - Detailed workflow guide
54- `README.md` - Project overview