Skip to content

chore(deps): use @uxfront/layer-docs 0.8.4's menu toggle and code themes - #85

Merged
alexgrozav merged 1 commit into
mainfrom
layer-docs-toggle-uxf-819
Nov 17, 2026
Merged

alexgrozav merged 1 commit into
mainfrom
layer-docs-toggle-uxf-819

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The docs move to @uxfront/layer-docs 0.8.4, which now ships the two fixes this site kept its own copies of. So the copies go:

  • app/components/IconMenuToggle.vue is deleted. The layer's toggle replaces Docus's in the same way, and it's named "Open menu" or "Close menu".
  • The content.build.markdown.highlight.theme block is gone from nuxt.config.ts. The layer sets the same GitHub high-contrast themes, with all three keys.
  • AGENTS.md and the "Keeping 100s" section of .github/CONTRIBUTING.md now say that the layer does both, and how to switch the code theme.

0.8.4 also drops the wordmark link's aria-label, so the link's name is its visible text. On this site it changes from "Open Components" to "OpenComponents", which fixes Lighthouse's label-content-name-mismatch on every docs page.

@uxfront/layer-docs 0.8.4 and the @uxfront/ui 0.9.1 and @uxfront/scene 0.5.1 it depends on were published less than 24 hours ago, so all three are in minimumReleaseAgeExclude until they age in, as in #29. The site itself stays on @uxfront/ui 0.6.0 and @uxfront/scene 0.5.0. The layer only imports one icon from its own copy of @uxfront/ui. DocsPageHeaderLinks.vue and modules/hydration-ids.ts stay.

What I checked on the built site:

  • The built HTML of /docs/getting-started/introduction has one <button aria-label="Open menu">, the header toggle. At phone size in Chrome, it takes focus with a visible ring, says "Close menu" once it's open and "Open menu" again once it's closed, and its lines don't animate under prefers-reduced-motion.
  • Every --shiki-* token colour on the 88 built pages with highlighted code reaches 4.5:1 on the code block background, in light (lowest 4.83:1 on zinc 50) and dark mode (lowest 7.02:1 on zinc 800).
  • The wordmark link has no aria-label, and its text is "OpenComponents".
  • Lighthouse 13.6 on wrangler dev, mobile and desktop, on /docs/getting-started/introduction, /docs/components/button/ux and /docs/components/button/dx: Accessibility is 100 on all six runs. button-name and color-contrast pass, and label-content-name-mismatch is "not applicable", since axe only tests a link whose name the page sets.

Checklist

  • The title follows Conventional Commits, as in feat(docs): add the focus guideline.
  • pnpm check-types passes.
  • Docs changes: the pages read well on pnpm dev. (Checked on the static build and wrangler dev instead. No page content changed.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes, but the dependency moved, so I ran it. Its assertions pass.)

@uxfront/layer-docs 0.8.4 names Docus's mobile menu toggle, sets
GitHub's high-contrast code themes and drops the wordmark's aria-label,
so the site's own IconMenuToggle.vue and highlight theme go. AGENTS.md
and CONTRIBUTING say the layer does both now. The release and the
@uxfront/ui and @uxfront/scene versions it brings are excluded from
pnpm's minimum release age until they age in.

Co-authored-by: multica-agent <github@multica.ai>
@alexgrozav
alexgrozav marked this pull request as ready for review November 16, 2026 22:02
@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://layer-docs-toggle-uxf-819.opencomponents.dev, https://layer-docs-toggle-uxf-819-opencomponents.blue-water-0397.workers.dev (commit cb8b73b)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://8f2df81e.opencomponents.dev, https://8f2df81e-opencomponents.blue-water-0397.workers.dev cb8b73b 2026-11-16T22:01:09.830Z Visit the dashboard ↗

@alexgrozav
alexgrozav merged commit 23f1577 into main Nov 17, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the layer-docs-toggle-uxf-819 branch November 17, 2026 06:03
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