Skip to content

feat(brand): preset cover for social preview and share image - #980

Draft
mehdibha wants to merge 29 commits into
mainfrom
claude/project-thread-ax67vo
Draft

mehdibha wants to merge 29 commits into
mainfrom
claude/project-thread-ax67vo

Conversation

@mehdibha

@mehdibha mehdibha commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

Requested by Mehdi · project thread

Summary

Before: the repo's social preview was the stale 2025 thumbnail, and the homepage share image was a text-only /og card.

After: one dark cover with the white dotUI wordmark in the centre and four preset containers around it in a pinwheel, running off the edges. Each container shows the studio preview canvas (the real cards) under a real preset in dark mode: Origin, Linear, Spotify and Airbnb. It is the GitHub social preview (www/public/brand/cover/github.png, 1280×640) and the site's default og:image / twitter:image (og.png, 2400×1260). Docs pages keep their per-page /og cards, and /studio keeps og-studio.png.

How:

  • /internal/cover (dev-only, like /internal/specimens) renders marketing/cover.tsx with real registry components through scoped DesignSystemProviders. Each container renders CardsCanvas at one fixed zoom and crops it; the SLOTS list sets each preset and position.
  • pnpm build:cover starts a dev server, screenshots the page at each size and writes www/public/brand/cover/.
  • The new Cover workflow runs on PRs touching presets, the registry, the showcase cards, @dotui/colors or the cover itself. It regenerates the images and commits them to the PR branch, so the cover always shows the real presets. Fork PRs are skipped. The workflows on that bot commit wait for an "Approve and run" click; a COVER_TOKEN secret (a fine-grained PAT or app token with contents write) makes them run without it.
  • Fix in DesignSystemProvider: a scoped provider with forcedMode now sets color-scheme. Without it, light-dark() tokens such as --color-card resolved to the page's mode, so a forced-dark card on a light page got a white surface. This also affects the preset picker's and docs demos' forced previews.
  • Removed siteConfig.og, which nothing reads any more.

After merging, upload www/public/brand/cover/github.png in the repo's Settings → Social preview. GitHub has no API for that.

🤖 Generated with Claude Code

https://claude.ai/code/session_0173tEVFVdYHpvC86SQVDUR2

Tagline is now "The design system studio for humans and agents" across
site meta, the root OG card and the README. Favicons and app icons are
regenerated from the logo (espresso square, white dot), with an SVG
favicon that inverts in dark mode, and the manifest theme colour matches.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYQbbHEVub7J29bSnnXmKc
The 96px PNG and the unsized ICO outranked favicon.svg, so the tab icon
never switched to the dark-mode mark. Size the ICO as the 32px fallback
and drop the PNG.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KYQbbHEVub7J29bSnnXmKc
One cover renders the same login card under five presets, fanned and
overlapped, beside the logo and tagline. `pnpm build:cover` screenshots
/internal/cover into www/public/brand/cover/ at GitHub's 1280x640 and the
2400x1260 share size. The site's default og:image now points at it, and a
Cover workflow regenerates it on PRs that touch presets or the registry.

Forced-mode scoped providers now set color-scheme, so light-dark() tokens
resolve to the pinned mode (a forced-dark card on a light page rendered a
light surface).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173tEVFVdYHpvC86SQVDUR2
@mehdibha mehdibha self-assigned this Oct 16, 2026
@vercel

vercel Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
dotui Ready Ready Preview Oct 19, 2026 10:38pm UTC
2 Skipped Deployments
Project Deployment Actions Updated
dotui-example-origin-next Ignored Ignored Preview Oct 19, 2026 10:38pm UTC
dotui-example-spotify-next Ignored Ignored Preview Oct 19, 2026 10:38pm UTC

@github-actions github-actions Bot added documentation Improvements or additions to documentation area: www The dotui.org app: site, landing, docs pages area: ci CI, workflows, repo tooling labels Oct 16, 2026
@coderabbitai

coderabbitai Bot commented Oct 16, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

claude and others added 2 commits October 16, 2026 20:48
The landing cards grid (three columns) under Origin, Linear dark and
Claude, cut into diagonal bands, replaces the fanned login cards. The
tagline uses the landing hero's type and sits vertically centred with the
logo. CardsGrid gains `side={false}` for a fixed three-column grid.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0173tEVFVdYHpvC86SQVDUR2
Base automatically changed from claude/project-thread-zmsjwp to main October 18, 2026 18:38
…-ax67vo

# Conflicts:
#	www/package.json
#	www/src/config/site.ts
#	www/src/routeTree.gen.ts
#	www/src/routes/__root.tsx
mehdibha and others added 3 commits October 19, 2026 18:14

This branch was successfully deployed

3 active (2 outdated) deployments
Preview – dotui — 9eff528c Deployed Oct 19, 2026 by vercel[bot]
Preview – dotui-example-spotify-next — 5c7adbb0 Deployed Oct 19, 2026 by vercel[bot]
Preview – dotui-example-origin-next — 5c7adbb0 Deployed Oct 19, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: ci CI, workflows, repo tooling area: www The dotui.org app: site, landing, docs pages documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants