GoFish Internals

This is the internal architecture wiki for GoFish Graphics — narrative essays about how the library works, why it is built the way it is, and where it is going.

It is written for contributors and for Claude. Unlike the JavaScript and Python docs, which teach you to use GoFish, these pages explain the machinery: the layout pipeline, the coordinate system, the type-level tricks, the Python bridge, and the design philosophy behind it all.

Start here

• New to the codebase? Read the Architecture Overview.
• Writing or editing an essay? See How This Wiki Works for the authoring conventions — frontmatter, sidebar sections, the covers: ↔ code back-links, diagrams, and code samples.

The wiki is broken into five sections:

• Overview — orientation: this page, the architecture map, the design philosophy, and a glossary.
• Frontend — the surface API a chart author writes: pipeline syntax, marks and operators, axes, and labels.
• Core — the rendering engine: underlying space, the layout and scale-resolution passes, and rendering itself.
• Python — the Python wrapper and its bridge to the JavaScript engine.
• Speculative Notes — design exploration and project direction that may never ship.