- README — what this is, what works, how to build and run it
- Getting Started — first build and first boot
- Quick Reference — build, run and debug commands on one page
- Project Evolution Retrospective — a historical account of the project's development
- Featured In — the Action Retro video and its findings on the tested revision
- Memory Management — zones, handles, and how the heap is sized
- malloc Prevention — why the kernel does not use malloc/free
- Known Issues — current limitations and resolved incident history
- Compatibility Gaps — where the Toolbox differs from Inside Macintosh
- Bare Metal — real-hardware support and what remains
| Component | Documentation |
|---|---|
| Window Manager | WindowManager.md |
| Menu Manager | MenuManager.md |
| Event Manager | EventManager.md |
| Dialog Manager | DialogManager/ |
| Control Manager | ControlManager/ |
| Font Manager | FontManager/ |
| Resource Manager | ResourceManager.md |
| Serial Logging | System/Logging.md |
| Desk Accessories | src/DeskManager/ — Calculator, Alarm Clock, Key Caps, Note Pad, Chooser |
| Patterns | src/PatternMgr/ and patterns.json — 17 colour ppat and 32 black-and-white PAT resources; Patterns.rsrc is generated during the build |
- Contributing
- Porting plan — other architectures
- Refactoring plan — the platform layer
System7/
├── README.md
├── config/ # build configurations
├── docs/ # project and subsystem documentation
│ ├── components/ # subsystem guides
│ └── future/ # planning documents
├── include/ # headers, by subsystem
├── resources/ # localized strings, patterns, and device trees
├── scripts/ # repository checks and generation helpers
├── src/ # implementation, by subsystem
├── tests/ # test harnesses, guest programs, and test notes
├── tools/ # asset and image utilities
└── patterns.json # pattern sources for the generated Patterns.rsrc
The integration tests live in src/Integration/IntegrationTests.c and run when
the kernel is built with INTEGRATION_TESTS=1.