Skip to content

Show X, Slack, and the star count in the docs' and Explorer's header, and move the theme switch to the footer - #11251

Open
lwwmanning wants to merge 5 commits into
developfrom
wm/wide-header
Open

lwwmanning wants to merge 5 commits into
developfrom
wm/wide-header

Conversation

@lwwmanning

@lwwmanning lwwmanning commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

This PR changes the shared header and footer on the docs and the Explorer, to match vortex.dev and bench. It copies design system v128.

  • The header uses the 1440px page column, centred (v127). In the docs, the wordmark aligns with the sidebar.
  • The header shows X and Slack as grey icons next to the GitHub button. Slack is no longer a text link.
  • The GitHub button shows the star count. The docs and the Explorer read it at build time, with GITHUB_TOKEN when the build has one. Below 1180px, the button hides the count.
  • The theme switch moves to the end of the footer. The Explorer shows its footer on the start page only, so the switch is not on screen while a file is open.
  • Below 960px, X and Slack move into the Menu. The GitHub and Menu buttons show only an icon.

The theme bootstrap now moves the Explorer's old vortex-theme storage key through the system's legacy option. vortex-data/vortex.dev#195 makes the same header change on the site.

Before After
1440px, header
800px, header
800px, open Menu
375px, header
375px, open Menu
1440px, footer
375px, footer
Light theme
Before After
1440px, header
800px, header
800px, open Menu
375px, header
375px, open Menu
1440px, footer
375px, footer

The page-width cap, at 2560px:

Before After
Docs
Explorer

🤖 Generated with Claude Code

On a wide screen the header now takes the same 1440px column as on
vortex.dev and bench, with its line rule, instead of the full window.

The theme bootstrap also copies a choice found only in storage into the
shared cookie, so a choice saved before the cookie existed reaches every
surface. The Explorer's old 'vortex-theme' key moves through the
bootstrap's legacy option.

Signed-off-by: Will Manning <will@willmanning.io>
@lwwmanning lwwmanning added the changelog/docs A docs change label Nov 4, 2026
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 4, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-05T02:21:30.364882Z 87c4859 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

…r's header

Slack leaves the shared header's text links. Its mark and X's are icon
links before the GitHub button, in the nav links' muted ink, and rows in
the Menu on a phone. The GitHub button drops the repository's name, which
moves to its title. The marks are their owners' (REUSE.toml). Copies
design system v128.

Signed-off-by: Will Manning <will@willmanning.io>
The docs (vortex_theme.py) and the Explorer (vite.config.ts) read the
repository's star count when they build, as vortex.dev does, so the
GitHub button is the same on every surface. The reads send GITHUB_TOKEN
when the build has one. Without an answer the button shows the mark alone.

Signed-off-by: Will Manning <will@willmanning.io>
…elow 1180px

At 800px the header row was crowded once X and Slack sat beside the GitHub
button. Below 1180px the GitHub button shows the mark alone, and the count
stays in its accessible name. Below 960px X and Slack go into the Menu with
the links. Below 640px the theme switch and GitHub follow, as before.

The Menu also showed the spill rows (GitHub, and now Slack and X) between
641px and 960px, beside the same buttons on the row: the panel link rule
outranked the hide. The hide now names the panel.

Signed-off-by: Will Manning <will@willmanning.io>
…below 960px

The theme switch moves from the header to the footer, after the links. On a
phone it moves up to the line of the Linux Foundation mark, and below 360px
the mark is 10px tall so that both fit at 320px. The Menu has no Theme row.

Below 960px the header row is the wordmark, the tools, the GitHub mark, and
the Menu. The GitHub button drops its star count, which stays in its name.
The GitHub and Menu buttons are 32px squares with an icon only. X and Slack
go into the Menu from 960px, not 1180px.

On the Explorer the footer, and so the switch, shows on the start page only.

Signed-off-by: Will Manning <will@willmanning.io>
@lwwmanning lwwmanning changed the title Cap the header at the page's width on the docs and the Explorer Show X, Slack, and the star count in the docs' and Explorer's header, and move the theme switch to the footer Nov 5, 2026

This branch was successfully deployed

1 active deployment
vercel-docs — 87c4859e Deployed Nov 5, 2026 by lwwmanning via Publish preview / Deploy #8446
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog/docs A docs change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants