Command palette shell
The command-menu pattern in the same persistent sidebar/header shell as the other App screens patterns: a search-style Button in the header opens a real CommandPalette (also bound to ⌘/Ctrl+K via useCommandPalette), with grouped, icon-labeled, keyword-searchable commands and a recent-items view when the query is empty.
Built with
How it’s built
- 01useCommandPalette wires the ⌘/Ctrl+K hotkey and open state; spread getPaletteProps() onto CommandPalette — the header's search Button just calls the same palette.open().
- 02emptyQueryItems shows a curated "recent" list before the visitor types anything; once they type, the built-in fuzzy filter takes over and matches keywords beyond the visible label (try "bill").
- 03The dialog traps focus, restores it to whichever control opened it (the header button or the ⌘K hotkey) on close, and closes on Escape.
Source
Three files · copy & pasteStyling: this source uses Tailwind utility classes and this site’s colour tokens (for example text-ink, bg-paper and border-line). The oks-ui components render without them; swap those classes for your own.
import { useState } from "react";
import { Button } from "oks-ui/button";
import { CommandPalette, useCommandPalette } from "oks-ui/command-palette";
import type { CommandPaletteItem } from "oks-ui/command-palette";
import type { NavItemData } from "oks-ui/nav";
import { AppShell } from "./AppShell";
import {
BriefcaseIcon,
CreditCardIcon,
GridIcon,
HelpCircleIcon,
PlusIcon,
ReceiptIcon,
SearchIcon,
SettingsIcon,
UsersIcon,
} from "./icons";
// A dashed square with a plus — "invite teammate".
const UserPlusIcon = ({ size = 16 }: { size?: number }) => {
return (
<svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
<circle cx="6.5" cy="6" r="2.5" />
<path d="M2 14c0-2.5 2-4 4.5-4s4.5 1.5 4.5 4" />
<path d="M13 5.5v4M11 7.5h4" />
</svg>
);
};
// A downward-pointing arrow into a tray — "export".
const ExportIcon = ({ size = 16 }: { size?: number }) => {
return (
<svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
<path d="M8 2.5v7M5 6.5 8 9.5l3-3" />
<path d="M2.5 12v1.5A1.5 1.5 0 0 0 4 15h8a1.5 1.5 0 0 0 1.5-1.5V12" />
</svg>
);
};
// A moon — "toggle theme".
const MoonIcon = ({ size = 16 }: { size?: number }) => {
return (
<svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
<path d="M13.5 9.5a5.5 5.5 0 1 1-7-7 4.3 4.3 0 0 0 7 7Z" />
</svg>
);
};
const NAV_ITEMS: NavItemData[] = [
{
key: "main",
label: "Main menu",
isSection: true,
children: [
{ key: "dashboard", label: "Dashboard", icon: <GridIcon size={18} /> },
{ key: "projects", label: "Projects", icon: <BriefcaseIcon size={18} /> },
{ key: "invoices", label: "Invoices", icon: <ReceiptIcon size={18} /> },
{ key: "team", label: "Team", icon: <UsersIcon size={18} /> },
],
},
{
key: "other",
label: "Other",
isSection: true,
children: [
{ key: "billing", label: "Billing", icon: <CreditCardIcon size={18} /> },
{ key: "settings", label: "Settings", icon: <SettingsIcon size={18} /> },
],
},
];
const ITEMS: CommandPaletteItem[] = [
{ id: "new-invoice", label: "Create invoice", group: "Actions", icon: <ReceiptIcon size={16} />, shortcut: ["⌘", "N"], keywords: ["bill", "new"] },
{ id: "invite", label: "Invite teammate", group: "Actions", icon: <UserPlusIcon />, keywords: ["team", "member"] },
{ id: "export", label: "Export data as CSV", group: "Actions", icon: <ExportIcon />, keywords: ["download"] },
{ id: "theme", label: "Toggle dark mode", group: "Actions", icon: <MoonIcon />, keywords: ["theme", "appearance"] },
{ id: "dashboard", label: "Go to Dashboard", group: "Navigation", icon: <GridIcon size={16} />, keywords: ["home", "overview"] },
{ id: "projects", label: "Go to Projects", group: "Navigation", icon: <BriefcaseIcon size={16} /> },
{ id: "team", label: "Go to Team", group: "Navigation", icon: <UsersIcon size={16} /> },
{ id: "billing", label: "Go to Billing & plans", group: "Navigation", icon: <CreditCardIcon size={16} /> },
{ id: "settings", label: "Open Settings", group: "Navigation", icon: <SettingsIcon size={16} /> },
{ id: "help", label: "Search the help center", group: "Support", icon: <HelpCircleIcon size={16} /> },
];
const RECENT_IDS = ["dashboard", "new-invoice", "team"];
const CommandPaletteShell = () => {
const [lastAction, setLastAction] = useState<string | null>(null);
const palette = useCommandPalette();
const recentItems = ITEMS.filter((item) => RECENT_IDS.includes(item.id));
return (
<>
<AppShell
navItems={NAV_ITEMS}
selectedNavKey="dashboard"
headerLeft={
<Button
variant="bordered"
size="sm"
onClick={palette.open}
startContent={<SearchIcon size={15} />}
className="w-full max-w-xs justify-between text-ink-faint"
endContent={
<span className="flex items-center gap-0.5 rounded-[var(--r-sm)] bg-paper-sunken px-1.5 py-0.5 text-[0.7rem] font-medium text-ink-faint">
⌘K
</span>
}
>
Search or jump to…
</Button>
}
contentClassName="flex flex-1 flex-col items-center justify-center gap-4 overflow-y-auto p-8 text-center"
>
<span className="flex h-14 w-14 items-center justify-center rounded-[var(--r-lg)] bg-[color:var(--oks-color-primary-50)] text-[color:var(--oks-color-primary-700)]">
<SearchIcon size={24} />
</span>
<div>
<p className="text-[1rem] font-semibold text-ink">Find anything, instantly</p>
<p className="mt-1 max-w-xs text-[0.85rem] text-ink-muted">
Press <kbd className="rounded-[var(--r-sm)] bg-paper-sunken px-1.5 py-0.5 font-sans text-[0.8rem]">⌘K</kbd> or the search bar above to jump to a
page, run an action, or search for help.
</p>
</div>
<Button color="primary" radius="full" startContent={<PlusIcon size={14} />} onClick={palette.open}>
Open command palette
</Button>
{lastAction ? <p className="text-[0.8rem] text-ink-faint">Last ran: {lastAction}</p> : null}
</AppShell>
<CommandPalette
{...palette.getPaletteProps()}
items={ITEMS}
emptyQueryItems={recentItems}
placeholder="Search commands, pages, and help…"
onSelect={(item) => setLastAction(item.label)}
/>
</>
);
};
export default CommandPaletteShell;It imports ./icons, so save this next to it:
export const BriefcaseIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<rect x="2" y="7" width="20" height="14" rx="2" />
<path d="M16 21V5a2 2 0 0 0-2-2h-4a2 2 0 0 0-2 2v16" />
<path d="M2 13h20" />
</svg>
);
};
export const CreditCardIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<rect x="2" y="5" width="20" height="14" rx="2" />
<path d="M2 10h20" />
</svg>
);
};
export const GridIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<rect x="3" y="3" width="7" height="7" rx="1.5" />
<rect x="14" y="3" width="7" height="7" rx="1.5" />
<rect x="3" y="14" width="7" height="7" rx="1.5" />
<rect x="14" y="14" width="7" height="7" rx="1.5" />
</svg>
);
};
export const HelpCircleIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<circle cx="12" cy="12" r="9" />
<path d="M9.5 9a2.5 2.5 0 0 1 4.8 1c0 1.5-2.3 1.8-2.3 3.5" />
<path d="M12 17.5h.01" />
</svg>
);
};
// Icons below this line were added for Horizon's rebuild into a business
// back-office (Finance/Accounts/HR and Payroll/Peoples/Contracts) --
// same "no icon library dependency" convention as everything above.
export const PlusIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<path d="M12 5v14M5 12h14" />
</svg>
);
};
export const ReceiptIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<path d="M5 3v18l2-1.5L9 21l2-1.5L13 21l2-1.5L17 21l2-1.5V3l-2 1.5L15 3l-2 1.5L11 3 9 4.5 7 3 5 4.5Z" />
<path d="M8 8h8M8 12h8" />
</svg>
);
};
export const SearchIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<circle cx="11" cy="11" r="7" />
<path d="M21 21l-4.3-4.3" />
</svg>
);
};
export const SettingsIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<circle cx="12" cy="12" r="3" />
<path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 1 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09a1.65 1.65 0 0 0-1.08-1.51 1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 1 1-2.83-2.83l.06-.06a1.65 1.65 0 0 0 .33-1.82 1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09a1.65 1.65 0 0 0 1.51-1.08 1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 1 1 2.83-2.83l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 1 1 2.83 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9c.26.42.7.7 1.19.83l.32.08c.6.15 1 .68 1 1.3v0" />
</svg>
);
};
export const UsersIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" />
<circle cx="9" cy="7" r="4" />
<path d="M23 21v-2a4 4 0 0 0-3-3.87" />
<path d="M16 3.13a4 4 0 0 1 0 7.75" />
</svg>
);
};
export const BellIcon = ({ size = 18 }: { size?: number }) => {
return (
<svg
width={size}
height={size}
viewBox="0 0 24 24"
fill="none"
stroke="currentColor"
strokeWidth={2}
strokeLinecap="round"
strokeLinejoin="round"
aria-hidden="true"
>
<path d="M6 8a6 6 0 0 1 12 0c0 4 1.5 5.5 2 6H4c.5-.5 2-2 2-6Z" />
<path d="M10 20a2 2 0 0 0 4 0" />
</svg>
);
};It imports ./AppShell, so save this next to it:
"use client";
import { useState, type ReactNode } from "react";
import { Avatar } from "oks-ui/avatar";
import { Button } from "oks-ui/button";
import { Dropdown, DropdownItem, DropdownMenu, DropdownTrigger } from "oks-ui/dropdown";
import { FormFieldSet } from "oks-ui/form-field-set";
import { Nav } from "oks-ui/nav";
import type { NavItemData } from "oks-ui/nav";
import "oks-ui/avatar.css";
import "oks-ui/button.css";
import "oks-ui/dropdown.css";
import "oks-ui/form-field-set.css";
import "oks-ui/nav.css";
import { BellIcon, HelpCircleIcon, SearchIcon, SettingsIcon } from "./icons";
// Two overlapping chevrons — a standard "collapse sidebar" glyph, not a
// reproduction of any specific icon set's artwork.
const CollapseIcon = () => {
return (
<svg width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.6" strokeLinecap="round" aria-hidden="true">
<path d="M6 3 2 8l4 5" />
<path d="M12 3 8 8l4 5" />
</svg>
);
};
const LogOutIcon = ({ size = 16 }: { size?: number }) => {
return (
<svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
<path d="M6 14H3.5a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1H6" />
<path d="M10.5 11 14 8l-3.5-3" />
<path d="M14 8H6" />
</svg>
);
};
export type AppShellProps = {
/** The sidebar tree — differs per pattern to match its app context (a Kanban tool's nav reads differently from an invoicing tool's). */
navItems: NavItemData[];
/** Omitted when the pattern being shown isn't one of the permanent nav rows (e.g. a Settings page reached from the account menu, not the sidebar itself). */
selectedNavKey?: string;
/** Lets a pattern make its own Nav row genuinely clickable (analytics-dashboard highlights whichever item — or account-menu action — was clicked last) instead of a fixed selectedNavKey. */
onSelectedNavKeyChange?: (key: string) => void;
/** Left side of the header, after the collapse toggle. Defaults to a plain search field; command-palette-shell overrides this with its ⌘K trigger button instead. */
headerLeft?: ReactNode;
/** Right side of the header, after the standard bell. Defaults to nothing extra. */
headerExtra?: ReactNode;
/** The scrollable main content (everything below the header). */
children: ReactNode;
/** Extra classes for the scrollable content wrapper — e.g. to drop the default padding for a pattern that wants edge-to-edge content. */
contentClassName?: string;
};
/**
* The one persistent sidebar/header app shell every "App screens" pattern on
* this site shares. Pulled out of each individual pattern file after the
* per-file copies drifted (one ended up with a different account name than
* the rest) — the account identity (Omkar Sahu) and the structural chrome
* (collapse toggle, Nav wiring, account Dropdown, bell) now live in exactly
* one place, while each pattern still supplies its own contextual nav items
* and can override the header's search slot when it needs to (the command
* palette trigger, for instance).
*/
export const AppShell = ({
navItems,
selectedNavKey,
onSelectedNavKeyChange,
headerLeft,
headerExtra,
children,
contentClassName,
}: AppShellProps) => {
const [collapsed, setCollapsed] = useState(false);
return (
// @container has to live on its OWN wrapper, not the element whose
// height is conditioned by @3xl: — an element can't query its own
// container for its own styling (circular per the CSS Containment
// spec), so @3xl:h-[46rem] would silently be evaluated against the
// wrong (ancestor) container and never apply.
<div className="@container w-full">
<div className="flex h-[32rem] w-full overflow-hidden bg-paper @3xl:h-[46rem]">
<aside
role="none"
className={`hidden h-full shrink-0 flex-col gap-6 overflow-y-auto overflow-x-hidden border-r border-line bg-paper-raised p-4 @3xl:flex ${collapsed ? "w-[4.5rem]" : "w-60"}`}
>
<div className="flex items-center px-1">
{/* Two files, swapped by theme — logo.svg carries dark ink and would
vanish against the dark sidebar. eslint-disable: fixed static
assets already sized for this slot; next/image's runtime cost
isn't worth it here. */}
{/* eslint-disable-next-line @next/next/no-img-element */}
<img src="/logo.svg" alt="oks-ui" className="oks-logo-for-light h-8 w-8 shrink-0" />
{/* eslint-disable-next-line @next/next/no-img-element */}
<img src="/logo-light.svg" alt="oks-ui" className="oks-logo-for-dark h-8 w-8 shrink-0" />
</div>
<Nav
aria-label="Main"
items={navItems}
selectedKey={selectedNavKey}
onItemSelect={onSelectedNavKeyChange ? (item) => onSelectedNavKeyChange(item.key) : undefined}
isCollapsed={collapsed}
classNames={{ base: "w-full", sectionTitle: collapsed ? "sr-only" : undefined }}
renderItem={({ isActive, content, props }) => (
<button type="button" {...props} className={`${props.className} flex items-center gap-1.5`}>
{!collapsed ? (
<span
aria-hidden="true"
className="h-1.5 w-1.5 shrink-0 rounded-full"
style={{ background: isActive ? "var(--oks-color-primary-600)" : "transparent" }}
/>
) : null}
{content}
</button>
)}
/>
<Dropdown placement="top-start" className="mt-auto w-full" classNames={{ content: "block w-full" }}>
<DropdownTrigger>
<Button
variant="ghost"
fullWidth
className={`gap-2.5 p-2 ${collapsed ? "justify-center" : "justify-start"}`}
>
<Avatar src="/avatar-omkar.jpg" name="Omkar Sahu" size="sm" radius="full" />
{!collapsed ? (
<span className="min-w-0 flex-1 text-left">
<span className="block truncate text-[0.85rem] font-medium text-ink">Omkar Sahu</span>
<span className="block truncate text-[0.75rem] text-ink-muted">me@oks-ui.com</span>
</span>
) : null}
</Button>
</DropdownTrigger>
<DropdownMenu
aria-label="Account menu"
onAction={onSelectedNavKeyChange ? (key) => onSelectedNavKeyChange(String(key)) : undefined}
>
<DropdownItem key="settings" startContent={<SettingsIcon size={16} />}>
Settings
</DropdownItem>
<DropdownItem key="help" startContent={<HelpCircleIcon size={16} />} showDivider>
Help desk
</DropdownItem>
<DropdownItem key="logout" startContent={<LogOutIcon size={16} />} classNames={{ title: "text-[color:var(--oks-color-danger-700)]" }}>
Log out
</DropdownItem>
</DropdownMenu>
</Dropdown>
</aside>
<div className="flex min-w-0 flex-1 flex-col overflow-hidden">
<header className="flex shrink-0 flex-wrap items-center justify-between gap-3 border-b border-line px-5 py-3.5 @3xl:px-8">
<div className="flex min-w-0 flex-1 items-center gap-3">
<Button
isIconOnly
variant="ghost"
size="sm"
onClick={() => setCollapsed((c) => !c)}
aria-label={collapsed ? "Expand sidebar" : "Collapse sidebar"}
className="hidden @3xl:flex"
>
<CollapseIcon />
</Button>
{headerLeft ?? (
<FormFieldSet
type="search"
name="headerSearch"
label="Search"
placeholder="Search"
startIcon={<SearchIcon size={16} />}
classNames={{ base: "w-full max-w-xs", label: "sr-only", control: "border-transparent bg-paper-sunken" }}
/>
)}
</div>
<div className="flex items-center gap-3">
{headerExtra}
<Button isIconOnly aria-label="Notifications" variant="ghost" radius="full" size="sm" className="relative">
<BellIcon size={18} />
<span aria-hidden="true" className="absolute right-2 top-2 h-1.5 w-1.5 rounded-full" style={{ background: "var(--oks-color-danger-500)" }} />
</Button>
<Avatar src="/avatar-omkar.jpg" name="Omkar Sahu" size="sm" radius="full" />
</div>
</header>
<div className={contentClassName ?? "flex flex-1 flex-col gap-5 overflow-y-auto p-5 @3xl:p-8"}>{children}</div>
</div>
</div>
</div>
);
};More patterns

Analytics dashboardApp screens
A full fintech app screen — collapsible sidebar, header search, wallet cards, an earnings chart, savings goals, and a transactions table.

Settings panelApp screens
A real settings screen — top tabs, two-column sections, and a sortable, selectable billing history table.

Data table viewApp screens
A full documents list screen — status Tabs, a filter toolbar, and a sortable, selectable Table with real recipient avatars.