Skip to content

Polish documentation menus and page navigation - #220

Merged
maxktz merged 5 commits into
mainfrom
feat/ui-adjustments
Sep 27, 2026
Merged

maxktz merged 5 commits into
mainfrom
feat/ui-adjustments

Conversation

@maxktz

@maxktz maxktz commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Standardize documentation dropdown sizing, spacing, icon styling, and hover colors using shared Tailwind color tokens.
  • Align hover backgrounds across docs navigation, search, agent controls, and landing header links while preserving Copy Page button behavior.
  • Restyle previous and next page links with the Copy Page inset-card treatment and shared hover border color.

Validation

  • pnpm --filter web lint
  • pnpm --filter web typecheck
  • pnpm exec oxfmt --check on changed files

Summary by cubic

Standardizes hover and menu styling across documentation and navigation components using new shared color tokens, and restyles previous/next page links to match the Copy Page inset-card treatment.

Key changes

  • Adds subtle-hover, subtle-hover-border, and subtle-hover-foreground tokens for both light and dark themes.
  • Deduplicates dropdown, context menu, and menubar item styling into shared constants.
  • Simplifies the menubar to delegate styling, content, and keyboard handling to the shared dropdown-menu components.
  • Switches docs sidebar, search, brand menu, and landing header hovers from muted to the new subtle-hover token.
  • Rebuilds prev/next footer links as inset cards with an icon and shared hover border.

Written for commit 7e1ffc5. Summary will update on new commits.

Review in cubic

Summary by CodeRabbit

  • Style
    • Updated hover states across navigation, buttons, and menus with subtler background, border, and text colors.
    • Refined dropdown and context-menu sizing, spacing, focus states, and icon styling.
    • Restyled documentation page navigation cards with a secondary background, directional icons, and clamped page titles.
    • Adjusted branding links and menu icons for a more consistent appearance.

@vercel

vercel Bot commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated
paykit Ready Ready Preview Sep 27, 2026 5:08pm UTC

@coderabbitai

coderabbitai Bot commented Sep 27, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Advanced

Run ID: 1555f3a4-28b3-4d0e-a601-21eea80ca668

📥 Commits

Reviewing files that changed from the base of the PR and between 7b261b9 and 7e1ffc5.

📒 Files selected for processing (1)
  • apps/web/src/components/docs/docs-page.tsx
🚧 Files skipped from review as they are similar to previous changes (1)
  • apps/web/src/components/docs/docs-page.tsx

Included review availability: This review used your included allowance. Your plan provides up to 4 included reviews per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The change adds subtle-hover theme tokens and applies them to shared menus, navigation, and documentation controls. It also changes brand-link styling and the layout of previous and next documentation cards.

Changes

UI Styling

Layer / File(s) Summary
Add subtle-hover theme tokens
apps/web/src/styles/globals.css, apps/web/src/components/ui/button.tsx
The light and dark themes define subtle-hover colors. The ghost button uses subtle-hover background and foreground utilities on hover.
Update shared menu styling
apps/web/src/components/ui/context-menu.tsx, apps/web/src/components/ui/dropdown-menu.tsx, apps/web/src/components/ui/menubar.tsx
Context menus, dropdown menus, and menubars use shared styles for content, items, labels, separators, and focus states. Menubar components remove local styles in several areas.
Apply hover styling to navigation and docs
apps/web/src/components/layout/*, apps/web/src/components/docs/copy-markdown-button.tsx, apps/web/src/components/docs/docs-layout.tsx, apps/web/src/components/web/brand-menu.tsx
Navigation and documentation controls use subtle-hover styling. Brand links and dropdown controls also change explicit styling classes.
Restyle documentation footer cards
apps/web/src/components/docs/docs-page.tsx
Previous and next cards use a secondary background with a separate icon area. The item name is line-clamped.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 7e1ff

The inspected styling changes preserve copying and previous/next page navigation. No actionable merge-blocking risk is established.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 2.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 42 functions across 10 files. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main changes to documentation menus and page navigation.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
  • Fix all pre-merge checks with AI
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

A rabbit taps a menu with care,
Soft hover colors bloom there.
Cards point onward, neat and bright,
Icons settle left or right.
The rabbit hops through themes anew.

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

@cubic-dev-ai cubic-dev-ai Bot 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.

1 issue found across 11 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/web/src/components/ui/menubar.tsx">

<violation number="1" location="apps/web/src/components/ui/menubar.tsx:26">
P3: This adds a `menuItemStyles` constant byte-identical to the one in dropdown-menu.tsx, splitting one shared definition across two files just as the PR was unifying menu styling. Export it from dropdown-menu.tsx (or a shared constants module) and import it here so future spacing/color tweaks stay in sync.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread apps/web/src/components/docs/docs-page.tsx Outdated
import { cn } from "@/lib/utils";

const menuItemStyles =
"relative flex cursor-default items-center gap-1.5 rounded-xs min-h-6.75 px-2 py-0.5 text-sm text-muted-foreground outline-hidden select-none focus:bg-subtle-hover focus:text-subtle-hover-foreground data-inset:pl-7 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg]:size-3.5";

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P3: This adds a menuItemStyles constant byte-identical to the one in dropdown-menu.tsx, splitting one shared definition across two files just as the PR was unifying menu styling. Export it from dropdown-menu.tsx (or a shared constants module) and import it here so future spacing/color tweaks stay in sync.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At apps/web/src/components/ui/menubar.tsx, line 26:

<comment>This adds a `menuItemStyles` constant byte-identical to the one in dropdown-menu.tsx, splitting one shared definition across two files just as the PR was unifying menu styling. Export it from dropdown-menu.tsx (or a shared constants module) and import it here so future spacing/color tweaks stay in sync.</comment>

<file context>
@@ -22,6 +22,9 @@ import {
 import { cn } from "@/lib/utils";
 
+const menuItemStyles =
+  "relative flex cursor-default items-center gap-1.5 rounded-xs min-h-6.75 px-2 py-0.5 text-sm text-muted-foreground outline-hidden select-none focus:bg-subtle-hover focus:text-subtle-hover-foreground data-inset:pl-7 data-disabled:pointer-events-none data-disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg]:size-3.5";
+
 function Menubar({ className, ...props }: MenubarPrimitive.Props) {
</file context>

@maxktz
maxktz merged commit c7572ff into main Sep 27, 2026
11 checks passed

This branch was successfully deployed

1 active deployment
Preview — 7e1ffc58 Deployed Sep 27, 2026 by vercel[bot]
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