Architecture

D3-TUI follows a modular, layered architecture designed specifically for the Sega Dreamcast hardware constraints. The system is built upon three foundational technologies from the FROM House ecosystem: KOS (KallistiOS) as the primary Dreamcast SDK, SPECTRE as the PVR2 hardware abstraction layer, and SHACHI as the asset pipeline pattern encyclopedia.

The architecture separates concerns into distinct modules: terminal emulation (VT100/ANSI), hardware-accelerated rendering via PVR2, font management, input handling, memory management, VMU integration, and SPECTRE/SHACHI integration. Each module implements specific stage briefs (SB-001 through SB-013) that define detailed specifications and requirements.

Data flows from user applications through the public API into core library modules, which interact with hardware through the SPECTRE abstraction layer. The asset pipeline processes raw D2 disc assets through SHACHI patterns before consumption by rendering and font subsystems. Build automation and testing infrastructure surround the core implementation, providing CI/CD capabilities and validation.