How twoguysdev/explorer-for-penpot works
Explorer for Penpot is a VS Code extension for browsing Penpot teams, projects, files, pages, and boards, then previewing a board or page in an editor tab. Users connect to Penpot Cloud or a self-hosted server with a token; the extension validates and stores it, loads the sidebar tree through the Penpot API, and renders SVG previews with optional thumbnail comparison and browser links. The shown source supports the main orchestration and rendering paths; the API and tree excerpts document the read-only data interactions. Localization and broader rendering details are documented capabilities.
Main entry points: preview.ts Preview panel · extension.ts Extension commands · tree.ts Sidebar tree · api.ts Penpot API client
Components 12
Connection & commands
- Extension commands
src/extension.ts - Errors & warnings
src/messages.ts - VS Code secret storage
Design browsing
- Sidebar tree
src/tree.ts - Penpot API client
src/api.ts
Preview rendering
- Preview panel
src/preview.ts - SVG renderer
src/render.ts - Preview webview
src/preview.ts
External services
- Penpot server
- Penpot editor
- Google Fonts
Other components
- VS Code user
Connections 17
- VS Code user → Extension commands: invokes commands
src/extension.ts - Extension commands → VS Code secret storage: reads/writes token
src/extension.ts - Extension commands → Penpot API client: validates token
src/extension.ts - Extension commands → Sidebar tree: registers and refreshes
src/extension.ts - Extension commands → Preview panel: opens preview
src/extension.ts - Extension commands → Penpot editor: opens editor link
src/extension.ts - Sidebar tree → Penpot API client: loads hierarchy and pages
src/tree.ts - Penpot API client → Penpot server: sends authenticated reads
src/api.ts - Preview panel → Penpot API client: fetches page and assets
src/preview.ts - Preview panel → Sidebar tree: uses cached page data
src/preview.ts - Preview panel → SVG renderer: renders objects
src/preview.ts - SVG renderer → Preview panel: returns SVG and warnings
src/render.ts - Preview panel → Preview webview: displays preview and thumbnail
src/preview.ts - Preview panel → Penpot editor: opens selected design
src/preview.ts - Preview panel → Google Fonts: loads optional fonts
README.md - Sidebar tree → Errors & warnings: formats load errors
src/tree.ts - Preview panel → Errors & warnings: formats render notices
src/preview.ts