# Brand Atoms Changelog

Amendments to the Vecreal brand atom layer. Newest first.

---

## 2026-05-11 (afternoon) · Wordmark Rebalance — Option F (rev-3)

**Scope:** Wordmark composition tokens only. Triggered by operator review of the morning's rev-2 lockdown — the combination of cap-height V (0.72em) AND enlarged dot (0.22em) felt over-balanced, with two heavyweight anchors bookending "ecreal." Drafted a 7-variant comparison page (`wordmark-rebalance-2026-05-11.html`) showing Current + 6 rebalance options at SM 22px / LG 48px / HERO 96px. Operator selected **Option F** — softens both V and dot in lockstep so neither dominates.

**Locked values (Option F):**

| Token | rev-2 | rev-3 (Option F) | Rationale |
|---|---|---|---|
| `.bk-wordmark .bk-v` height | `0.72em` | `0.66em` | Below cap-height; V no longer dominates lowercase "ecreal" |
| `--bk-v-margin-right` | `-0.13em` | `-0.11em` | Slackened to suit smaller V's narrower visual footprint |
| `--bk-dot-size` | `0.22em` | `0.20em` | Reduced in lockstep with V; preserves dot's presence as terminal punctuation without competing |
| `--bk-dot-margin-left` | `calc(0.04em + 2px)` | unchanged | Pre-dot breath unaffected by rebalance |

**Geometry untouched:** V SVG path, Inter Semibold "ecreal" glyph paths, contained app-icon (D-half) favicon, open monogram. Only proportions and spacing change.

**`assets/wordmark.svg` regenerated:**
- V scale factor: `39.85` → `35.57` (renders V at 0.66em instead of 0.72em)
- Letter translates: shifted **-147 each** (e=1340, c=2449, r=3539, e=4250, a=5359, l=6432) to seat under the smaller V with -0.11em margin
- Dot: `cx=7272, cy=-205, r=205` (was cx=7440, cy=-226, r=226)
- viewBox unchanged at `-50 -1536 7800 2048`

**Files touched:**
- `assets/wordmark.svg` — fully regenerated
- `reference-design-system.html` — `:root` tokens; `.bk-wordmark .bk-v`/`.bk-dot` CSS rules; spec tables; provenance row added; ~13 inline demo card hardcoded styles swept
- `reference-visual-mockups.html` — token block + bk-wordmark CSS rules updated to match
- `design-tokens.json` — `brandMark` group + `lockedRootVariables` array updated
- `component-library/wordmark.md` — status to rev-3; composition rules; sizes; operator-tuning history; lock signature
- `index.html` (brand-atoms landing) — wordmark CSS updated
- `marketing/landing/index.html` (vecreal.com) — bk-wordmark CSS tokens updated
- `marketing/landing/assets/og-preview.html` + regenerated `og-preview.png` (1200×630)

**Workshop artifact (kept in place for audit):**
- `wordmark-rebalance-2026-05-11.html` — 7-variant comparison page that drove the decision

**Approval:** Operator final acceptance: "I like option F. Lets lock that in everywhere, propogate please" (2026-05-11 afternoon).

---

## 2026-05-11 · Wordmark + Favicon Amendment (rev-2 of wordmark; D-half lock for contained monogram)

**Scope:** Wordmark composition tokens, V SVG geometry, trailing dot proportions, contained app-icon (favicon) monogram, all consumers across `projects/vecreal/drafts/brand-atoms/` and `projects/vecreal/marketing/landing/`.

**Operator:** Yuriy, via 5-round amendment workshop in `drafts/brand-atoms/amendment-workshop-2026-05-11*.html`.

**Locked decisions:**

| Token / asset | Prior (rev-1) | Locked (rev-2) | Rationale |
|---|---|---|---|
| V case | lowercase chevron | UPPERCASE chevron | Matches text usage "Vecreal", monogram alignment, institutional positioning, GC vocabulary, AI-startup differentiation, longevity |
| `.bk-wordmark .bk-v` height | `0.56em` (x-height) | `0.72em` (cap-height) | Reads as bookend opening letter, not a sub-letter element |
| `--bk-v-margin-right` | `-0.07em` | `-0.13em` | Tighter V-to-e seal for uppercase cohesion |
| `--bk-dot-size` | `0.18em` | `0.22em` | Assertive trailing punctuation; bookends with uppercase V |
| `--bk-dot-margin-left` | `0.04em` | `calc(0.04em + 2px)` | Pre-dot breath; fixed-pixel component keeps visual gap consistent across sizes |
| Contained app-icon V path | `M14 18 L31 48 Q32 50 33 48 L50 18 L42 18 L32 34 L22 18 Z` | `M10 18 L27 48 Q28 50 29 48 L46 18 L38 18 L28 34 L18 18 Z` (shifted -4 in X) | "D-half" lock; centers V under the tile alongside enlarged dot |
| Contained app-icon dot | `cx=46 cy=46 r=5` | `cx=47.5 cy=42 r=6.5` | "D-half" lock; r=6.5 balances assertiveness with 64×64 tile economy |
| Wordmark SVG viewBox | `-50 -1600 7296 1700` | `-50 -1536 7800 2048` | Bugfix: prior height ≠ Inter upm (2048); SVG was rendering ~22% larger than CSS at the same height value. Now pixel-for-pixel with CSS bk-wordmark. |

**Geometry left unchanged:** V SVG path (chevron shape itself); Inter Semibold "ecreal" glyph paths.

**Universal favicon:** Locked variant L from Round 5 — clay tile (#A05847) + soft-white V+dot (#FAFAF8). Single favicon works on any tab-bar color (light & dark); separate dark-mode favicon not needed.

**Files touched:**

- `assets/wordmark.svg` — fully replaced with locked content; staging file `wordmark-NEW-PROPOSED.svg` removed.
- `reference-design-system.html` — token block (`--bk-v-margin-right`, `--bk-dot-size`, `--bk-dot-margin-left`); `.bk-wordmark .bk-v` and `.bk-wordmark .bk-dot` CSS rules; spec tables; demo card hardcoded inline styles swept; contained app-icon V path + dot geometry swapped to D-half; provenance rows added.
- `reference-visual-mockups.html` — token block + bk-wordmark CSS rules updated to match.
- `design-tokens.json` — `brandMark` group + `lockedRootVariables` array updated; `bk-v-height` added for completeness.
- `component-library/wordmark.md` — status to rev-2; composition rules; sizes; operator-tuning history; lock signature.
- `marketing/landing/coming-soon.html`, `coming-soon-v2-list.html`, `coming-soon-v3-flow.html`, `coming-soon-v4-grid.html`, `coming-soon-option-2-watermark.html`, `coming-soon-option-3-twocol.html` — inline SVG bodies swapped to locked geometry; favicon data URI swapped to locked D-half contained variant.
- `marketing/landing/coming-soon-v5-grid.html` — bk-wordmark CSS tokens updated (V height, V-e margin, dot size); favicon data URI swapped to locked D-half.
- `marketing/landing/coming-soon-binder-asset-prompt.md` — illustrative SVG snippet updated to locked geometry.

**Workshop artifacts** (kept in place for audit history):

- `amendment-workshop-2026-05-11.html` (Round 1)
- `amendment-workshop-2026-05-11-round2.html` (Round 2)
- `amendment-workshop-2026-05-11-round3.html` (Round 3)
- `amendment-workshop-2026-05-11-round4.html` (Round 4 — D vs D-half adjudication)
- `amendment-workshop-2026-05-11-round5-darkfavicon.html` (Round 5 — dark-mode candidates DA/DB/DC/DD; L variant locked as universal default)
- `wordmark-svg-translation-review.html` (SVG-to-CSS pixel-for-pixel comparison sweep used to verify viewBox fix)

**Approval:** Operator final acceptance: "Ok looks good. Matches. Lets lock it in and propogate everywhere both the CSS and SVG versions" (2026-05-11).