Skip to content

Docs-site chrome: 'Part of btravstack' strip, bigger hero mark + glow#22

Merged
btravers merged 2 commits into
mainfrom
design/docs-chrome
Jul 3, 2026
Merged

Docs-site chrome: 'Part of btravstack' strip, bigger hero mark + glow#22
btravers merged 2 commits into
mainfrom
design/docs-chrome

Conversation

@btravers

@btravers btravers commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Brings the shared docs-site chrome in line with the Claude Design mockups. Publishes @btravstack/theme@1.5.0 (minor) on merge.

The four docs sites weren't matching the mockup in three ways — all shared chrome, so all fixed once in the theme:

  • "Part of btravstack" strip beneath every page — the org beetroot mark + btravstack wordmark, linking back to the hub. Rendered via a layout-bottom slot in the theme's Layout (the package now ships a tiny Vue render; vue/vitepress are externalized in the build).
  • Larger home-hero mark — the project logos ship at a small intrinsic size, so max-width alone left them tiny; now stretched to ~300px like the mockup.
  • Broad accent glow shape behind the hero (previously just a small halo hugging the logo) + a slightly larger nav logo.

Everything derives from the existing --accent token, so each site keeps its own color (orange / indigo / green / violet).

Verified locally against the amqp-contract docs (dark + light): hero, glow, and footer strip all render correctly.

Follow-up

Once 1.5.0 is published, the four open docs PRs (amqp #523, temporal #282, unthrown #60, demesne #11) get their catalog pin bumped 1.4.0 → 1.5.0 to pick up the chrome.

🤖 Generated with Claude Code

- add a 'Part of btravstack' org-attribution strip beneath every page
  (layout-bottom slot in the shared theme's Layout)
- enlarge the home-hero mark (the logos ship at a small intrinsic size)
- add a broad accent glow shape behind the hero + a larger nav logo
- externalize vue/vitepress in the build so the Layout render is not bundled

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 3, 2026 10:18

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Aligns the shared @btravstack/theme VitePress chrome with the design mockups across all docs sites by adding a bottom attribution strip and updating the home hero/nav visuals, packaged as a minor theme release.

Changes:

  • Adds a global “Part of btravstack” attribution strip rendered via the theme Layout’s layout-bottom slot.
  • Updates shared CSS to increase nav logo sizing and add a larger home-hero mark + broader accent glow shape.
  • Updates the theme build config to externalize vue/vitepress runtime imports.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
packages/theme/tsdown.config.ts Externalizes vue/vitepress modules from the theme bundle.
packages/theme/src/style.css Adjusts nav logo sizing; adds new home hero glow/mark sizing and attribution strip styling.
packages/theme/src/index.ts Adds Vue-rendered attribution strip and wires it into DefaultTheme.Layout via a slot.
.changeset/docs-chrome.md Declares the minor release and documents the user-facing chrome changes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/theme/src/index.ts Outdated
Comment thread packages/theme/src/style.css Outdated
/* ── Home hero: a bigger mark + a large accent glow shape ─────────
The default hero only has a small glow hugging the logo; the docs
mockups show a broad accent wash bleeding off the top-right. */
.VPHome { position: relative; overflow: clip; }
Comment on lines +174 to +178
color: var(--vp-c-text-3);
text-decoration: none;
transition: color 0.15s;
}
.btv-partof-link:hover { color: var(--vp-c-text-2); }
- rel="noopener noreferrer" on the external attribution link
- scope .VPHome to position:relative (avoid clipping vertical hover shadows)
- add :focus-visible to the attribution link for keyboard users

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@btravers

btravers commented Jul 3, 2026

Copy link
Copy Markdown
Contributor Author

All three addressed in the latest commit:

  • rel="noopener noreferrer" on the attribution link.
  • .VPHome scoped to just position: relative so the existing overflow-x: clip handles the glow bleed without clipping vertical hover-lift shadows.
  • Added a :focus-visible outline on the attribution link for keyboard users.

@btravers
btravers merged commit e91662d into main Jul 3, 2026
@btravers
btravers deleted the design/docs-chrome branch July 3, 2026 10:27
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