DEVVY UI — Build once. Style freely.

Usage

import { Navbar } from "@devvy-ui/react";

<Navbar label="Product" brand={<a href="/">Orbit</a>}>
  <a href="/overview" aria-current="page">Overview</a>
  <a href="/projects">Projects</a>
</Navbar>

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
label	string	required	Accessible name of the navigation.
brand	ReactNode	required	Your logo or home link.
actions	ReactNode	—	Account, search or other actions.
children	ReactNode	—	Native route links; aria-current on the active link.
menuLabel	string	Menu	Visible mobile toggle label.

Source ownership

Add the audited implementation directly into your repository with the CLI:

node /path/to/devvy-ui/packages/cli/src/cli.mjs add navbar

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Navbar.tsxREACT / TSX

'use client';
import { forwardRef, useId, useRef, useState, type HTMLAttributes, type ReactNode } from 'react';
import { cx } from '../lib/cx';

export interface NavbarProps extends Omit<HTMLAttributes<HTMLElement>, 'aria-label'> {
  label: string;
  brand: ReactNode;
  actions?: ReactNode;
  menuLabel?: string;
}
/** Responsive disclosure navigation. Links keep native Tab and browser navigation behavior. */
export const Navbar = forwardRef<HTMLElement, NavbarProps>(function Navbar(
  { label, brand, actions, menuLabel = 'Menu', children, className, onKeyDown, ...props },
  ref,
) {
  const id = useId();
  const trigger = useRef<HTMLButtonElement>(null);
  const [open, setOpen] = useState(false);
  return (
    // Escape bubbles from links and buttons; the nav itself is never made focusable.
    // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions
    <nav
      {...props}
      ref={ref}
      aria-label={label}
      className={cx('dvy-navbar', className)}
      data-open={open || undefined}
      onKeyDown={(event) => {
        onKeyDown?.(event);
        if (!event.defaultPrevented && event.key === 'Escape' && open) {
          event.preventDefault();
          setOpen(false);
          trigger.current?.focus();
        }
      }}
    >
      <div className="dvy-navbar-brand">{brand}</div>
      <button
        ref={trigger}
        type="button"
        className="dvy-navbar-toggle"
        aria-expanded={open}
        aria-controls={id}
        onClick={() => setOpen((value) => !value)}
      >
        <svg
          viewBox="0 0 24 24"
          width="20"
          height="20"
          fill="none"
          stroke="currentColor"
          strokeWidth="1.5"
          aria-hidden="true"
        >
          <path d={open ? 'M6 6l12 12M6 18L18 6' : 'M4 7h16M4 12h16M4 17h16'} />
        </svg>
        {menuLabel}
      </button>
      <div id={id} className="dvy-navbar-content">
        <div className="dvy-navbar-links">{children}</div>
        {actions && <div className="dvy-navbar-actions">{actions}</div>}
      </div>
    </nav>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Navbar

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.