Ballmac UI home

Menu BarPRO

A translucent macOS menu bar on Radix Menubar: a bold app menu, menus with key equivalents, submenus and checkmarks, a status area with icon buttons and a hydration-safe live clock.

Installation

  1. Get a Pro licence key.

    The source is part of Ballmac UI Pro.

    Log in with your licence key to read and copy it here, or install it through the shadcn CLI or the MCP server. You own the code once it is in your project.

    $49 once regular price $99for this and every other Pro item. Tax included.Money back if it does not work.

  2. Once per project: add the Pro registry and your licence key.

    components.json
    {
      "registries": {
        "@ballmac": "https://ui.ballmac.com/r/{name}.json",
        "@ballmac-pro": {
          "url": "https://ui.ballmac.com/r/pro/{name}.json",
          "headers": { "Authorization": "Bearer ${BALLMAC_LICENSE_KEY}" }
        }
      }
    }
    .env.local
    BALLMAC_LICENSE_KEY=your-licence-key
  3. Add it.

    $ pnpm dlx shadcn@latest add @ballmac-pro/menu-bar

Usage

import { MenuBar, MenuBarCheckboxItem, MenuBarClock, MenuBarContent, MenuBarGroup, MenuBarItem, MenuBarLabel, MenuBarMenu, MenuBarSeparator, MenuBarShortcut, MenuBarStatus, MenuBarStatusItem, MenuBarSub, MenuBarSubContent, MenuBarSubTrigger, MenuBarTrigger } from "@/components/ballmac/menu-bar"

The full example is in the Code tab above.

API reference

<MenuBarTrigger>

PropTypeDefault
variant

"app" sets the trigger in bold, like the application menu next to the logo.

"default" | "app""default"

<MenuBarContent>

PropTypeDefault
portal

Render into a portal on document.body (default). Set false to keep the menu inside its container, e.g. in a mockup.

booleantrue

<MenuBarItem>

PropTypeDefault
inset

Indent the label to line up with checkbox items.

boolean—
variant

Red text for destructive actions.

"default" | "destructive""default"

<MenuBarSubContent>

PropTypeDefault
portal

Render into a portal on document.body (default).

booleantrue

<MenuBarClock>

PropTypeDefault
locale

BCP 47 locale for formatting. Fixed by default so server and browser agree.

string"en-US"
format

Intl options. Default: short weekday, month, day, and hour:minute.

Intl.DateTimeFormatOptionsdefaultClockFormat
value

Show a fixed time instead of the live clock (useful for mockups and screenshots).

Date—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabFocuses the menu bar (one stop), then the status buttons
ArrowLeft / ArrowRightMoves between menus, also while one is open
Enter / Space / ArrowDownOpens the focused menu
ArrowUp / ArrowDown, typeaheadMoves between items
EscapeCloses the menu and returns focus to its trigger

Quality scorecard

6/6

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.0, across 1 example.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (0% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    5 tab stops, each showing a visible change when it takes focus. 5 documented keys.

  • Not applicable: Loading, empty and error

    Does not show data or take submissions.

  • For information: Automated tests

    No test file of its own yet.

  • For information: Footprint

    3.2 KB of source (gzip) in 1 file. Installs radix-ui, lucide-react.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Use with AI

<MenuBar> holds <MenuBarMenu value><MenuBarTrigger/><MenuBarContent>items</MenuBarContent></MenuBarMenu> (Radix Menubar parts with Mac styling) followed by <MenuBarStatus> with <MenuBarStatusItem aria-label> icon buttons and <MenuBarClock />. Use variant="app" on the app-name trigger and <MenuBarShortcut> for key equivalents. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Menu Bar (@ballmac-pro/menu-bar) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • A Mac desktop mockup or product hero where the app's menus should really open
  • A web app that wants desktop-style menus with keyboard navigation (File, Edit, View)
  • Status bars that pair a few icon buttons with a clock

Not for

  • Site navigation for a marketing page (use a header with links)
  • A single action menu on a button (use a dropdown menu)

Registry JSON (needs your licence key): https://ui.ballmac.com/r/pro/menu-bar.json

Credits

Covered by the Ballmac UI Pro license.

Registry
shadcn/utils