Skip to content

docs(assets): OGAR logo + favicon (hand-authored SVG), wired into both READMEs#103

Merged
AdaWorldAPI merged 1 commit into
mainfrom
claude/ogar-logo-asset
Jun 22, 2026
Merged

docs(assets): OGAR logo + favicon (hand-authored SVG), wired into both READMEs#103
AdaWorldAPI merged 1 commit into
mainfrom
claude/ogar-logo-asset

Conversation

@AdaWorldAPI

Copy link
Copy Markdown
Owner

What

Two hand-authored SVG assets under docs/assets/, wired into both READMEs.

File Size viewBox Purpose
ogar-logo.svg 1.2 KB 320×150 Wordmark — bisected O + outgoing edge + leaf dot + "GAR" in geometric sans
ogar-favicon.svg 556 B 64×64 Just the bisected O, optimized for 16-64px favicon use

Geometry notes

The bisector sits 2 units above the O's geometric centre. That makes the lower half slightly heavier than the upper half — a deliberate signature of the 32-bit classid's hi/lo asymmetry:

  • Lower half (heavier) = the shared canonical concept (lo u16) — the bedrock every app stands on
  • Upper half (lighter) = the per-app render lens (hi u16) — the swappable skin

The outgoing edge descends from the bottom of the O — semantically from the concept half — to a leaf dot, signalling graph (not just registry).

Style

  • fill="currentColor" throughout: adapts to GitHub light/dark mode without needing media-query <picture> switches
  • Pure vector geometry — no gradients, no shadows, no embedded fonts
  • Wordmark uses a system-font stack (Inter, 'IBM Plex Sans', 'Helvetica Neue', Arial, system-ui, …) so rendering falls back gracefully across platforms
  • Validated as well-formed XML via xmllint

README integration

Both README.md and README.de.md now lead with the inline logo:

``&lt;img src="docs/assets/ogar-logo.svg" alt="OGAR" height="64"/&gt;``

# OGAR — Open Graph of Active Record

> **English** · [Deutsch](README.de.md) · [Philosophy](docs/PHILOSOPHY.md)

H1 heading preserved below the image for accessibility and semantic structure (the alt text on the <img> is also OGAR).

Iteration handles

If the proportions need tuning later, the load-bearing constants are:

  • Bisector y-position (line 14 of ogar-logo.svg, y="56" — vs geometric centre at y=58)
  • Outer/inner radii (45 / 27) — controls ring thickness
  • Wordmark font-size (92) and letter-spacing (-3)
  • Edge length (22) and dot radius (6)

Generated by Claude Code

Two SVG assets under docs/assets/:

- ogar-logo.svg (1.2 KB, viewBox 320x150) — wordmark: a bisected O glyph
  with an outgoing edge to a leaf dot, followed by "GAR" in a clean
  geometric sans (Inter / IBM Plex / system-ui fallback). The bisector
  sits 2u above the O's geometric center so the lower half (the shared
  canonical concept) reads slightly heavier than the upper half (the
  per-app render lens) — the hi/lo asymmetry of a 32-bit classid as a
  visual signature.

- ogar-favicon.svg (556 B, viewBox 64x64) — just the bisected O,
  optimized for 16-64px favicon use. Drops the edge+dot which wouldn't
  survive at small sizes.

Both use fill="currentColor" for light/dark theme adaptation; no
gradients, no shadows, no embedded fonts. Validated as well-formed XML
via xmllint.

Wired into the top of both README.md and README.de.md as a 64px-tall
inline image, preserving the H1 heading below for accessibility and
semantic structure.
@AdaWorldAPI AdaWorldAPI merged commit 561c7bb into main Jun 22, 2026
1 check passed
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.

2 participants