Visual assets guide

Diagrams and screenshots live under ../../assets/. Each asset is embedded on at least one Academy page; this guide helps you find the right visual quickly.

Overview illustrations

Asset	Illustrates	Used on
	Quick Start, Glossary, Academy docs, and three reader paths	Documentation map
	Development-time UGM → Graft generation → runtime IIP calls	What is Graftcode, Architecture
	REST/DTO/client stack vs public methods and Grafts	What problem does Graftcode solve
	What metadata may go to cloud vs what stays on-prem	What goes to Graftcode Cloud

Graftcode Vision (screenshots)

Asset	Illustrates	Used on
	Explorer, public types, Installation panel	First run and Vision
	Copy install command from npm tab	First run and Vision, Install a Graft
	Configuration tab — `GraftConfig.host` snippet	First run and Vision, Install a Graft, GraftConfig reference
	Interactive method execution	First run and Vision, Debugging runbook
	MCP client JSON from Vision Connect tab	MCP: expose tools

Architecture and flow diagrams

Asset	Illustrates	Used on
	WebSocket, HTTP, TCP, HTTP/2 and client types	Ports, protocols, and CORS
	Choose in-memory, WebSocket, TCP, or HTTP/2	Transport: TCP, WebSocket, HTTP/2
	In-memory, polyglot, and remote execution	In-memory vs remote cookbook
	Per-Graft config in one application	Configure multiple Grafts
	Env vars, files, and code precedence	GraftConfig reference
	Session and scaling implications	Stateless vs stateful execution
	Portal → Gateway → registry → consumer	Project Key and Registry URL
	`--types` facade vs full module	Filtering exposed types
	Static methods to MCP and Graft consumers	MCP: expose tools
	REST and Graft facade sharing core logic	REST and Graftcode coexistence

Operations, security, and scaling

Asset	Illustrates	Used on
	Transport, plugins, registry, edge client	Authentication and authorization
	Stateless round-robin vs stateful stickiness	Scaling, load balancers, and proxies
	Systematic debug path	Debugging runbook
	Trace context across Graft call	Observability setup

These articles point to the visuals above:

Edge client authentication — see Auth layers
Observability, tracing, and context propagation — see Observability setup
Public interface vs business logic — see Filtering exposed types
Transport security TLS/WSS — see Gateway ports
Troubleshooting runbook — see Debugging runbook

File locations (for maintainers)

Folder	Contents
`assets/images/`	Screenshots and overview PNGs
`assets/diagrams/`	Generated flow and architecture PNGs

When adding a new screenshot, update this page and the README in the corresponding assets folder.