Timace

Sidebar nav

Install
npm install react-aria-components
components/ui/sidebar-nav.tsx
"use client";

import type { ReactNode } from "react";
import { Link, type LinkProps } from "react-aria-components";

export interface SidebarNavProps {
  /** Above the links: a logo, a workspace switcher. */
  header?: ReactNode;
  /** Below the links: the account, a usage meter. */
  footer?: ReactNode;
  /** Names the navigation for screen readers. */
  label?: string;
  children: ReactNode;
  className?: string;
}

/** The navigation down the side of an app. Group its links with SidebarNavSection. */
export function SidebarNav({ header, footer, label = "Main", children, className }: SidebarNavProps) {
  return (
    <aside
      data-slot="sidebar-nav"
      className={[
        "flex w-(--tui-sidebar-nav-width) max-w-full flex-col gap-(--tui-sidebar-nav-gap) border-solid border-(--tui-sidebar-nav-border) border-r-(length:--tui-sidebar-nav-border-width) bg-(--tui-sidebar-nav-bg) p-(--tui-sidebar-nav-padding) font-(family-name:--tui-font) text-(length:--tui-sidebar-nav-font-size) text-(--tui-sidebar-nav-fg)",
        className,
      ]
        .filter(Boolean)
        .join(" ")}
    >
      {header}
      <nav aria-label={label} className="flex min-h-0 flex-1 flex-col gap-(--tui-sidebar-nav-gap) overflow-y-auto">
        {children}
      </nav>
      {footer}
    </aside>
  );
}

export function SidebarNavSection({ title, children }: { title?: ReactNode; children: ReactNode }) {
  return (
    <div className="flex flex-col gap-(--tui-sidebar-nav-item-gap)">
      {title && <div className="px-(--tui-sidebar-nav-item-padding-x) pb-1 text-[0.85em] leading-none font-medium text-(--tui-sidebar-nav-muted)">{title}</div>}
      {children}
    </div>
  );
}

export interface SidebarNavItemProps extends Omit<LinkProps, "className" | "children"> {
  icon?: ReactNode;
  /** A count or a word on the right. */
  badge?: ReactNode;
  /** The page you are on. */
  isCurrent?: boolean;
  children: ReactNode;
  className?: string;
}

export function SidebarNavItem({ icon, badge, isCurrent, children, className, ...props }: SidebarNavItemProps) {
  return (
    <Link
      aria-current={isCurrent ? "page" : undefined}
      {...props}
      className={[
        "flex h-(--tui-sidebar-nav-item-height) cursor-pointer items-center gap-2.5 rounded-(--tui-sidebar-nav-item-radius) px-(--tui-sidebar-nav-item-padding-x) leading-none font-(--tui-sidebar-nav-item-weight) text-(--tui-sidebar-nav-muted) no-underline outline-none transition-colors duration-(--tui-duration) aria-[current=page]:bg-(--tui-sidebar-nav-current-bg) aria-[current=page]:text-(--tui-sidebar-nav-fg)! data-focus-visible:[outline:var(--tui-sidebar-nav-ring-width)_solid_var(--tui-sidebar-nav-ring)] data-focus-visible:[outline-offset:var(--tui-sidebar-nav-ring-offset)] data-hovered:bg-(--tui-sidebar-nav-item-bg-hover) data-hovered:text-(--tui-sidebar-nav-fg) [&_svg]:size-[1.25em] [&_svg]:shrink-0",
        className,
      ]
        .filter(Boolean)
        .join(" ")}
    >
      {icon}
      <span className="min-w-0 flex-1 truncate">{children}</span>
      {badge && <span className="shrink-0 rounded-full bg-(--tui-sidebar-nav-badge-bg) px-1.5 py-0.5 text-[0.82em] font-medium text-(--tui-sidebar-nav-badge-fg) tabular-nums">{badge}</span>}
    </Link>
  );
}
styles/timace-ui.css
:root {
  color-scheme: light;
  --tui-bg: #ffffff;
  --tui-fg: #0a0a0a;
  --tui-muted: #f5f5f5;
  --tui-muted-fg: #737373;
  --tui-border: #e5e5e5;
  --tui-primary: #171717;
  --tui-primary-fg: #fafafa;
  --tui-ring: #a3a3a3;
  --tui-success: #16a34a;
  --tui-warning: #d97706;
  --tui-danger: #dc2626;
  --tui-radius: 8px;
  --tui-border-width: 1px;
  --tui-space: 4px;
  --tui-shadow: none;
  --tui-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
  --tui-text: 14px;
  --tui-duration: 150ms;

  /* Sidebar nav */
  --tui-sidebar-nav-width: 248px;
  --tui-sidebar-nav-padding: calc(var(--tui-space) * 3);
  --tui-sidebar-nav-gap: calc(var(--tui-space) * 5);
  --tui-sidebar-nav-item-height: calc(var(--tui-space) * 9);
  --tui-sidebar-nav-item-padding-x: calc(var(--tui-space) * 2.5);
  --tui-sidebar-nav-item-gap: calc(var(--tui-space) * 0.5);
  --tui-sidebar-nav-item-radius: var(--tui-radius);
  --tui-sidebar-nav-border-width: var(--tui-border-width);
  --tui-sidebar-nav-font-size: var(--tui-text);
  --tui-sidebar-nav-item-weight: 500;
  --tui-sidebar-nav-bg: var(--tui-bg);
  --tui-sidebar-nav-fg: var(--tui-fg);
  --tui-sidebar-nav-muted: var(--tui-muted-fg);
  --tui-sidebar-nav-border: var(--tui-border);
  --tui-sidebar-nav-badge-bg: var(--tui-muted);
  --tui-sidebar-nav-badge-fg: var(--tui-muted-fg);
  --tui-sidebar-nav-item-bg-hover: var(--tui-muted);
  --tui-sidebar-nav-current-bg: var(--tui-muted);
  --tui-sidebar-nav-ring: var(--tui-ring);
  --tui-sidebar-nav-ring-width: 2px;
  --tui-sidebar-nav-ring-offset: 2px;
}

.dark,
[data-theme="dark"] {
  color-scheme: dark;
  --tui-bg: #0a0a0a;
  --tui-fg: #fafafa;
  --tui-muted: #1c1c1c;
  --tui-muted-fg: #a3a3a3;
  --tui-border: #2a2a2a;
  --tui-primary: #fafafa;
  --tui-primary-fg: #171717;
  --tui-ring: #737373;
  --tui-success: #22c55e;
  --tui-warning: #f59e0b;
  --tui-danger: #ef4444;
}

Needs Tailwind CSS v4. Import the stylesheet once, after Tailwind.