Skip to content

docs: crisp, theme-aware logo on the landing page - #298

Open
ChristopherPHolder wants to merge 2 commits into
mainfrom
docs/crisp-logo
Open

ChristopherPHolder wants to merge 2 commits into
mainfrom
docs/crisp-logo

Conversation

@ChristopherPHolder

Copy link
Copy Markdown
Collaborator

What

The landing page logo looked pixelated on large and high-density screens, sat awkwardly in the hero, and showed up twice on mobile. Its black outline also almost disappeared in dark mode.

  • Crisp mark: the 170px PNG is replaced by images/user-flow-mark.svg, rebuilt from that PNG rather than redrawn. The outline is the centre line of the original line work, refitted as smooth even-width strokes. The portholes and antenna tip are true rings, and the dome fills are smoothed regions in the original palette. It's 26 KB (11 KB gzipped).
  • Dark mode: the header and hero draw the mark with <svg><use href="images/user-flow-mark.svg#mark">. The outline (stroke) and body (color) follow new --logo-ink / --logo-paper tokens, so in dark mode the UFO has a light outline on a dark body. Opened on its own, the file still renders black on white.
  • Layout: the hero only repeats the mark on wide screens, where it fills the second column, aligned with the top of the hero copy. On mobile the header logo is enough.
  • .nvmrc: nx build docs crashes during route extraction on Node 22.18 (Cannot read properties of undefined (reading 'exports')). The repo already requires >=22.19, so .nvmrc lets nvm use pick a current Node 22.

Checked

  • Dev server at desktop and phone widths, light and dark, with both the system setting and the theme toggle.
  • nx build docs on Node 22.22.3: 18 routes prerendered. I served the built site under /user-flow/ and the mark resolves from nested docs pages.

The 170px PNG mark blurred at hero size and on high-density screens, its
black outline vanished in dark mode, and on mobile the hero repeated the
logo right under the header.

- Rebuild the mark as vector art from the PNG: the outline is the line
  work's centre line refitted as even-width strokes, the portholes and
  antenna tip are true rings, and the dome fills are smoothed palette
  regions. 26 KB, 11 KB gzipped.
- Draw it with <svg><use> so the outline (stroke) and body (color)
  follow new --logo-ink / --logo-paper tokens, light and dark.
- Show the hero mark only on wide screens, aligned with the top of the
  hero copy.
The docs build needs Node >=22.19 (see engines). On 22.18 Angular's route
extraction crashes with "Cannot read properties of undefined (reading
'exports')", so let nvm pick up a current Node 22.
@github-actions

Copy link
Copy Markdown

❗❗❗ report generated by this PR ❗❗❗

☕ Order Coffee ☕

Date/Time: 2026-10-31 10:56

Step Name Gather Mode Performance Accessibility Best Practices Seo Agentic Browsing
🧭 Navigate to coffee cart navigation 80 93 100 83 50
☕ Select coffee timespan 17/17 - 8/8 - -
✔ Coffee selected snapshot Ø 1/1 16/18 4/4 3/5 1/3
🛒 Checkout order timespan 19/19 - 8/8 - -
🧾 Order checked out snapshot Ø 1/1 19/20 4/4 3/5 1/3
💌 Submit order timespan 17/17 - 8/8 - -
📧 Order submitted snapshot Ø 1/1 20/22 4/4 3/5 1/3
🧭 Navigate to github navigation 99 92 100 83 50

@github-actions

Copy link
Copy Markdown

☕ Order Coffee ☕

Date/Time: 2026-10-31 10:56

Step Name Gather Mode Performance Accessibility Best Practices Seo Agentic Browsing
🧭 Navigate to coffee cart navigation 88 93 100 83 50
☕ Select coffee timespan 17/17 - 8/8 - -
✔ Coffee selected snapshot Ø 1/1 16/18 4/4 3/5 1/3
🛒 Checkout order timespan 19/19 - 8/8 - -
🧾 Order checked out snapshot Ø 1/1 19/20 4/4 3/5 1/3
💌 Submit order timespan 18/18 - 8/8 - -
📧 Order submitted snapshot Ø 1/1 20/22 4/4 3/5 1/3
🧭 Navigate to github navigation 100 92 100 83 50

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