Skip to content
Shaken UI
Sign in

Menubar

Save

An application menubar with File, Edit, and View style menus, submenus, checkbox and radio items, and shortcuts, built on Base UI Menubar with the Dropdown Menu surface.

Category
Overlays
Version
0.1.1
Frameworks
Next.js, Vite + React
Styling
Tailwind CSS v4

Preview

Menubar preview

Installation

npx @shakenui/cli add menubar

Review the plan first. A dry run lists every file and package without changing anything:

npx @shakenui/cli add menubar --dry-run

Usage

menubar-example.tsx
"use client";

import { useState } from "react";
import {
  Menubar,
  MenubarCheckboxItem,
  MenubarContent,
  MenubarGroup,
  MenubarItem,
  MenubarLabel,
  MenubarMenu,
  MenubarRadioGroup,
  MenubarRadioItem,
  MenubarSeparator,
  MenubarShortcut,
  MenubarSub,
  MenubarSubContent,
  MenubarSubTrigger,
  MenubarTrigger,
} from "@/components/shaken/ui/menubar";

const recent = ["acme-web", "agent-runtime", "billing-service"];

export default function MenubarExample() {
  const [wordWrap, setWordWrap] = useState(true);
  const [minimap, setMinimap] = useState(false);
  const [panel, setPanel] = useState("bottom");

  return (
    <Menubar>
      <MenubarMenu>
        <MenubarTrigger>File</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>
            New file
            <MenubarShortcut>⌘N</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            Open…
            <MenubarShortcut>⌘O</MenubarShortcut>
          </MenubarItem>
          <MenubarSub>
            <MenubarSubTrigger>Open recent</MenubarSubTrigger>
            <MenubarSubContent>
              {recent.map((name) => (
                <MenubarItem key={name}>
                  <span className="font-mono text-xs">{name}</span>
                </MenubarItem>
              ))}
              <MenubarSeparator />
              <MenubarItem>Clear recent</MenubarItem>
            </MenubarSubContent>
          </MenubarSub>
          <MenubarSeparator />
          <MenubarItem>
            Save
            <MenubarShortcut>⌘S</MenubarShortcut>
          </MenubarItem>
          <MenubarItem disabled>
            Save all
            <MenubarShortcut>⌥⌘S</MenubarShortcut>
          </MenubarItem>
          <MenubarSeparator />
          <MenubarItem destructive>Close workspace</MenubarItem>
        </MenubarContent>
      </MenubarMenu>

      <MenubarMenu>
        <MenubarTrigger>Edit</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>
            Undo
            <MenubarShortcut>⌘Z</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            Redo
            <MenubarShortcut>⇧⌘Z</MenubarShortcut>
          </MenubarItem>
          <MenubarSeparator />
          <MenubarItem>
            Find
            <MenubarShortcut>⌘F</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            Replace
            <MenubarShortcut>⌥⌘F</MenubarShortcut>
          </MenubarItem>
        </MenubarContent>
      </MenubarMenu>

      <MenubarMenu>
        <MenubarTrigger>View</MenubarTrigger>
        <MenubarContent>
          <MenubarCheckboxItem checked={wordWrap} onCheckedChange={setWordWrap}>
            Word wrap
            <MenubarShortcut>⌥Z</MenubarShortcut>
          </MenubarCheckboxItem>
          <MenubarCheckboxItem checked={minimap} onCheckedChange={setMinimap}>
            Minimap
          </MenubarCheckboxItem>
          <MenubarSeparator />
          <MenubarRadioGroup value={panel} onValueChange={setPanel}>
            <MenubarLabel>Panel position</MenubarLabel>
            <MenubarRadioItem value="bottom">Bottom</MenubarRadioItem>
            <MenubarRadioItem value="right">Right</MenubarRadioItem>
            <MenubarRadioItem value="hidden">Hidden</MenubarRadioItem>
          </MenubarRadioGroup>
        </MenubarContent>
      </MenubarMenu>

      <MenubarMenu>
        <MenubarTrigger>Agent</MenubarTrigger>
        <MenubarContent>
          <MenubarGroup>
            <MenubarItem>
              Start run
              <MenubarShortcut>⌘R</MenubarShortcut>
            </MenubarItem>
            <MenubarItem disabled>
              Stop run
              <MenubarShortcut>⌘.</MenubarShortcut>
            </MenubarItem>
            <MenubarItem>Review pending approvals</MenubarItem>
          </MenubarGroup>
          <MenubarSeparator />
          <MenubarItem>Open trace</MenubarItem>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  );
}

API

PropTypeDefaultDescription
Menubar orientation"horizontal" | "vertical""horizontal"Which arrow keys move between menus.
Menubar loopFocusbooleantrueWraps arrow-key focus from the last menu to the first.
Menubar disabledbooleanfalseDisables every menu in the bar.
MenubarMenuBase UI Menu.Root props—One menu: a MenubarTrigger and its MenubarContent.
MenubarTriggerBase UI Menu.Trigger props—The label in the bar, such as File. Tinted while its menu is open.
MenubarContent side / align / sideOffset / alignOffsetDropdown Menu content props"bottom" / "start" / 6 / -4Placement under the trigger.
MenubarItem / MenubarCheckboxItem / MenubarRadioGroup / MenubarRadioItemDropdown Menu and Context Menu item props—Actions, toggles, and single choices, with destructive and disabled states.
MenubarSub / MenubarSubTrigger / MenubarSubContentContext Menu submenu parts—Nested menus beside their trigger.
MenubarGroup / MenubarLabel / MenubarSeparator / MenubarShortcutDropdown Menu parts—Grouping, labels, dividers, and shortcut hints.

Accessibility

  • The bar has role="menubar" and its triggers are menuitems with aria-haspopup and aria-expanded.
  • Left and right arrows move between triggers; Enter, Space, or the down arrow opens a menu with its first item highlighted.
  • While a menu is open, the left and right arrows and hovering another trigger switch menus; the swap is instant with no animation.
  • Inside a menu, arrows, Home, End, and typeahead move the highlight; Escape closes the menu and returns focus to its trigger.
  • Checkbox and radio items announce their state with aria-checked; disabled items stay reachable.
  • With reduced motion the menu transitions are removed.

Files

Installed into src/components/shaken, or components/shaken when the project has no src directory.

  • src/components/shaken/ui/menubar.tsxmenubar
  • Also installs dropdown-menu@0.2.1registry dependency
  • Also installs context-menu@0.1.1registry dependency
  • npm packages: @base-ui/react@^1.9.0React and Tailwind CSS v4 required

Source

The exact source the CLI installs, from /r/items/react/menubar/0.1.1.json.

ui/menubar.tsxShow
ui/menubar.tsx
"use client";

import { Menu as BaseMenu } from "@base-ui/react/menu";
import { Menubar as BaseMenubar } from "@base-ui/react/menubar";
import {
  ContextMenuCheckboxItem,
  ContextMenuRadioGroup,
  ContextMenuRadioItem,
  ContextMenuSub,
  ContextMenuSubContent,
  ContextMenuSubTrigger,
} from "./context-menu";
import {
  DropdownMenuContent,
  type DropdownMenuContentProps,
  DropdownMenuGroup,
  DropdownMenuItem,
  DropdownMenuLabel,
  DropdownMenuSeparator,
  DropdownMenuShortcut,
} from "./dropdown-menu";

type ClassName<State> = string | ((state: State) => string | undefined) | undefined;

function cx(...classes: (string | false | null | undefined)[]) {
  return classes.filter(Boolean).join(" ");
}

/** Prepends base classes while keeping Base UI's state-function form of className working. */
function withBase<State>(base: string, className: ClassName<State>) {
  return typeof className === "function" ? (state: State) => cx(base, className(state)) : cx(base, className);
}

/**
 * The bar that holds the menus. Left and right arrows move between menu triggers, and once one
 * menu is open, hovering or arrowing to the next trigger opens that menu instead.
 */
export function Menubar({ className, ...props }: BaseMenubar.Props) {
  return (
    <BaseMenubar
      className={withBase(
        cx(
          "flex h-10 items-center gap-0.5 rounded-xl border border-zinc-950/10 bg-white p-1 text-zinc-950",
          "shadow-[0_1px_2px_rgb(0_0_0/0.04)] dark:border-white/10 dark:bg-black dark:text-white dark:shadow-[inset_0_1px_0_rgb(255_255_255/0.06)]",
        ),
        className,
      )}
      {...props}
    />
  );
}

/** One menu in the bar: a MenubarTrigger and its MenubarContent. */
export const MenubarMenu = BaseMenu.Root;

/** The label in the bar that opens a menu, such as File or Edit. */
export function MenubarTrigger({ className, ...props }: BaseMenu.Trigger.Props) {
  return (
    <BaseMenu.Trigger
      className={withBase(
        cx(
          "inline-flex h-8 cursor-default items-center rounded-lg px-2.5 text-sm font-medium text-zinc-700 outline-none select-none",
          // Colors only: moving between menus is quick and frequent, so nothing slides.
          "transition-colors duration-150 ease-out motion-reduce:transition-none",
          "hover:bg-zinc-950/[0.04] hover:text-zinc-950 data-[popup-open]:bg-zinc-950/[0.06] data-[popup-open]:text-zinc-950",
          "dark:text-zinc-300 dark:hover:bg-white/[0.06] dark:hover:text-white dark:data-[popup-open]:bg-white/[0.09] dark:data-[popup-open]:text-white",
          "focus-visible:outline-2 focus-visible:outline-solid focus-visible:-outline-offset-2 focus-visible:outline-sky-500",
          "data-[disabled]:pointer-events-none data-[disabled]:opacity-45",
        ),
        className,
      )}
      {...props}
    />
  );
}

export interface MenubarContentProps extends DropdownMenuContentProps {}

/**
 * A menu's panel. Shares its surface with Dropdown Menu. When focus moves from one open menu to
 * the next, the swap is instant rather than animated.
 */
export function MenubarContent({ sideOffset = 6, alignOffset = -4, className, ...props }: MenubarContentProps) {
  return (
    <DropdownMenuContent
      sideOffset={sideOffset}
      alignOffset={alignOffset}
      className={withBase("data-[instant]:transition-none", className)}
      {...props}
    />
  );
}

/** An action. `destructive` styles it for deleting; `disabled` keeps it visible but skips it. */
export const MenubarItem = DropdownMenuItem;

/** Groups related items. Put a MenubarLabel inside to name the group. */
export const MenubarGroup = DropdownMenuGroup;

/** Names a MenubarGroup or MenubarRadioGroup. Must be rendered inside the group it labels. */
export const MenubarLabel = DropdownMenuLabel;

/** A divider between groups of items. */
export const MenubarSeparator = DropdownMenuSeparator;

/** A keyboard shortcut hint shown at the end of an item. */
export const MenubarShortcut = DropdownMenuShortcut;

/** An item that toggles a setting, with a check in the leading slot when on. */
export const MenubarCheckboxItem = ContextMenuCheckboxItem;

/** Groups radio items so exactly one is chosen. */
export const MenubarRadioGroup = ContextMenuRadioGroup;

/** One choice in a MenubarRadioGroup. */
export const MenubarRadioItem = ContextMenuRadioItem;

/** Groups a submenu trigger with its panel. */
export const MenubarSub = ContextMenuSub;

/** An item that opens a submenu on hover, click, or the right arrow key. */
export const MenubarSubTrigger = ContextMenuSubTrigger;

/** The submenu panel, beside its trigger. */
export const MenubarSubContent = ContextMenuSubContent;