User Guide

Kaappi is a complete R7RS-small Scheme implementation written in Zig. It provides a bytecode compiler, register-based VM, mark-and-sweep garbage collector, first-class continuations, hygienic macros, and a full library system.

• Installation -- building from source on macOS and Linux
• Your First Program -- running files and using the REPL
• Scheme Tutorial -- learn Scheme from scratch with runnable examples
• Language Reference -- quick syntax lookup for every feature
• Libraries -- importing, authoring, and organizing libraries
• Advanced Features -- FFI, REPL commands, bytecode caching, debugger
• CLI Reference -- command-line options and standalone binaries
• Tips -- tail calls, bignums, Unicode, error handling
• Troubleshooting -- common errors and how to fix them

Prefer the browser? The interactive tour teaches the same fundamentals with live code, or jump straight into the playground to experiment.

---