How penpot/penpot works
Penpot is a browser-based collaborative design platform with a backend, editor-specific text and rendering runtimes, and extension surfaces. The principal workflow is a designer editing a document, collaborating with a team, and using design-system and developer-facing capabilities to carry the result toward implementation. The README documents these product relationships; the source index identifies several substantial runtime modules, but much of the application wiring was not sampled, so the graph avoids asserting detailed internal call chains.
Main entry points: app Design workspace · main.clj Application backend · PenpotMcpServer.ts MCP server · transform-to-token.ts Design tokens
Components 15
Design workspace
- Design workspace
frontend/src/app - Design tokens
plugins/apps/colors-to-tokens-plugin/src/app/utils/transform-to-token.ts - Code inspection
backend/src/app/rpc/commands/viewer.clj
Backend services
- Application backend
backend/src/app/main.clj - API commands
backend/src/app/rpc/commands - Document graph
backend/src/app/graph - File storage
backend/src/app/storage.clj - Collaboration transport
backend/src/app/http/websocket.clj - Media processing
media-processor/src/index.ts
Developer integrations
- Plugin runtime
plugins/libs/plugins-runtime/src/lib/plugin-manager.ts - MCP server
mcp/packages/server/src/PenpotMcpServer.ts - MCP plugin
mcp/packages/plugin/src/main.ts
Editor runtimes
- Text editing
frontend/text-editor/src/editor/TextEditor.js - Rendering engine
render-wasm/src/main.rs
Other components
- Designer
Connections 14
- Designer → Design workspace: designs in
- Design workspace → Text editing: edits text
- Design workspace → Rendering engine: renders designs
- Design workspace → Application backend: collaborates through
- Application backend → API commands: serves commands
- Application backend → Document graph: manages documents
- Application backend → File storage: persists files
- Design workspace → Design tokens: uses tokens
- Design workspace → Plugin runtime: extends via
- Design workspace → Code inspection: exposes code
- Design workspace → MCP server: connects design and code
- MCP server → MCP plugin: dispatches plugin tasks
- Application backend → Collaboration transport: supports real-time use
- Application backend → Media processing: processes media