Developer

How the library is verified, why it is built the way it is, and what was learned getting there.

   
Verification What “check” and “test” mean for CAD: OpenSCAD’s exit codes, the gate tiers, and why a valid solid proves little.
History What the pre-2026 implementation got right, and the defects found since the rewrite.
Decisions The architecture decision records.

Where a page gives a number, it was measured on OpenSCAD 2021.01. Where a check exists, it was validated by reintroducing the bug it catches; tests/guards/ holds those reintroductions.

Outstanding and deliberately deferred work is tracked in GitHub issues, not in a file.

Working on the library

just            # list recipes
just setup      # verify the toolchain
just check      # the commit gate: format, lint, guards, warnings, preview, renders
just test       # the assert-only tests
just verify     # slow: forced-CGAL manifoldness and the partspec contracts

The project rules are in AGENTS.md. Licence and provenance are in NOTICE.


Table of contents


This site uses Just the Docs, a documentation theme for Jekyll.