Skip to content

visual: a node's logo draws the product's official mark on its card - #99

Open
zintaen wants to merge 2 commits into
EricTechPro:mainfrom
zintaen:visual-node-logos
Open

zintaen wants to merge 2 commits into
EricTechPro:mainfrom
zintaen:visual-node-logos

Conversation

@zintaen

@zintaen zintaen commented Nov 1, 2026

Copy link
Copy Markdown

A map node can now carry logo: an SVG or PNG path relative to the map file, like an intake source's logo.
embed_logos inlines it at render, so the page still works offline, and the card draws it on a small white tile
where the kind sigil sits (the details panel too). The card's size, colour and tab do not change, so layouts and the
check are unaffected; a node without logo renders exactly as before. The mark is never recoloured, and the white
tile keeps it readable in both themes.

Why: architecture maps read faster when a card shows the product it runs on (GitHub, Postgres, Caddy ...). The idea
and the "official marks only, never recoloured" rule come from caru-ini/stack-diagram (MIT).

Tested: a three-node map with an SVG and a PNG logo renders with both inlined, check clean (0 crossings, 0 overlaps),
in light and dark. Changed: assets/template.html (card, panel, two CSS rules), scripts/visual.py
(embed_logos covers nodes), references/schema.md (the field).

Raised by Anh Trinh

🤖 Generated with Claude Code

… its card

A map node can carry `logo`, an SVG or PNG path relative to the map file like an intake
source's `logo`. embed_logos inlines it, and the card shows it on a small white tile where
the kind sigil sits (the details panel too). Card size, colour and layout do not change;
a node without `logo` renders as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@qodo-code-review

qodo-code-review Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Code Review by Qodo

Grey Divider

Sorry, something went wrong

We weren't able to complete the code review on our side. Please try again manually by commenting /agentic_review on this PR.

Grey Divider

Qodo Logo

@qodo-code-review

Copy link
Copy Markdown

PR Summary by Qodo

Show official product logos on visual map nodes

✨ Enhancement 📝 Documentation 🕐 10-20 Minutes

Grey Divider

AI Description

• Add optional SVG or PNG logos to map nodes for faster product recognition.
• Inline logo files so rendered maps remain usable offline.
• Show logos on white tiles in cards and details panels; preserve sigils when absent.
Diagram

graph TD
  A["Map JSON"] --> B["Map loader"] --> C["Logo embedder"] --> D["HTML page"] --> E["Node cards"]
  D --> F["Details panel"]
  G["Logo files"] --> C
Loading
High-Level Assessment

Extending the existing logo-inlining step is the best fit: it keeps maps self-contained and reuses the current rendering pipeline. Referencing image files directly from the browser would be simpler but would not reliably preserve offline viewing.

Files changed (3) +15 / -3

Enhancement (2) +13 / -3
template.htmlRender node logos on cards and in details +5/-2

Render node logos on cards and in details

• Adds white logo tiles for SVG card images and details-panel images without changing card geometry or kind styling. Nodes without a logo continue to show their existing kind sigil.

skills/visual/assets/template.html

visual.pyInline local node logos during map loading +8/-1

Inline local node logos during map loading

• Extends 'embed_logos' to convert existing node logo files into MIME-typed base64 data URLs, alongside its existing intake-logo handling. This keeps node marks available in the generated page offline.

skills/visual/scripts/visual.py

Documentation (1) +2 / -0
schema.mdDocument the optional node logo field +2/-0

Document the optional node logo field

• Adds a map-node example showing a logo path relative to the map file and explains that SVG or PNG marks are inlined and displayed in place of the sigil.

skills/visual/references/schema.md

…x tile

A card whose width came from its name ran the name under the logo tile. A card with a logo
now keeps its name 36 px clear on both sides (and grows to match), and the logo draws at
16 px centred in a 20 px tile, clear of the status tab.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant