Skip to content

Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.

feat(react): add a shared NavRail for the ERP and MES app shells

aashu6c7d2e715c0a
diff --git a/packages/locale/locales/de/mes.po b/packages/locale/locales/de/mes.po
index 7e61b803a5..067e286f03 100644
--- a/packages/locale/locales/de/mes.po
+++ b/packages/locale/locales/de/mes.po
@@ -354,9 +354,6 @@ msgstr "Abschluss läuft"
msgid "Connecting"
msgstr "Verbindung wird hergestellt"
-msgid "Console"
-msgstr "Konsole"
-
msgid "Console Mode"
msgstr "Konsolenmodus"
@@ -706,9 +703,6 @@ msgstr "Unzureichende Menge"
msgid "Inventory adjustment completed"
msgstr "Bestandskorrektur abgeschlossen"
-msgid "Inventory Adjustments"
-msgstr "Bestandskorrekturen"
-
msgid "is"
msgstr "ist"
@@ -1111,9 +1105,6 @@ msgstr "Öffnen Sie einen NCR für MRB-Verwendungsentscheid"
msgid "Open Jobs"
msgstr "Offene Fertigungsaufträge"
-msgid "Operations"
-msgstr "Arbeitsgänge"
-
msgid "Operations ended"
msgstr "Arbeitsgänge beendet"
@@ -1687,9 +1678,6 @@ msgstr "Heute"
msgid "Toggle the sidebar"
msgstr "Seitenleiste ein-/ausblenden"
-msgid "Tools"
-msgstr "Werkzeuge"
-
msgid "Total"
msgstr "Gesamtbetrag"
diff --git a/packages/locale/locales/en/mes.po b/packages/locale/locales/en/mes.po
index 8271726991..c9dc98e060 100644
--- a/packages/locale/locales/en/mes.po
+++ b/packages/locale/locales/en/mes.po
@@ -354,9 +354,6 @@ msgstr "Completing"
msgid "Connecting"
msgstr "Connecting"
-msgid "Console"
-msgstr "Console"
-
msgid "Console Mode"
msgstr "Console Mode"
@@ -706,9 +703,6 @@ msgstr "Insufficient quantity"
msgid "Inventory adjustment completed"
msgstr "Inventory adjustment completed"
-msgid "Inventory Adjustments"
-msgstr "Inventory Adjustments"
-
msgid "is"
msgstr "is"
@@ -1111,9 +1105,6 @@ msgstr "Open an NCR for MRB disposition"
msgid "Open Jobs"
msgstr "Open Jobs"
-msgid "Operations"
-msgstr "Operations"
-
msgid "Operations ended"
msgstr "Operations ended"
@@ -1687,9 +1678,6 @@ msgstr "Today"
msgid "Toggle the sidebar"
msgstr "Toggle the sidebar"
-msgid "Tools"
-msgstr "Tools"
-
msgid "Total"
msgstr "Total"
diff --git a/packages/locale/locales/es/mes.po b/packages/locale/locales/es/mes.po
index 9988076bc0..845cc03967 100644
--- a/packages/locale/locales/es/mes.po
+++ b/packages/locale/locales/es/mes.po
@@ -354,9 +354,6 @@ msgstr "Finalizando"
msgid "Connecting"
msgstr "Conectando"
-msgid "Console"
-msgstr "Consola"
-
msgid "Console Mode"
msgstr "Modo consola"
@@ -706,9 +703,6 @@ msgstr "Cantidad insuficiente"
msgid "Inventory adjustment completed"
msgstr "Ajuste de inventario completado"
-msgid "Inventory Adjustments"
-msgstr "Ajustes de inventario"
-
msgid "is"
msgstr "es"
@@ -1111,9 +1105,6 @@ msgstr "Abrir un NCR para la disposición de MRB"
msgid "Open Jobs"
msgstr "Órdenes de trabajo abiertas"
-msgid "Operations"
-msgstr "Operaciones"
-
msgid "Operations ended"
msgstr "Operaciones finalizadas"
@@ -1687,9 +1678,6 @@ msgstr "Hoy"
msgid "Toggle the sidebar"
msgstr "Alternar la barra lateral"
-msgid "Tools"
-msgstr "Herramientas"
-
msgid "Total"
msgstr "Total"
diff --git a/packages/locale/locales/fr/mes.po b/packages/locale/locales/fr/mes.po
index 776c1a9634..b125dc499d 100644
--- a/packages/locale/locales/fr/mes.po
+++ b/packages/locale/locales/fr/mes.po
@@ -354,9 +354,6 @@ msgstr "Finalisation"
msgid "Connecting"
msgstr "Connexion..."
-msgid "Console"
-msgstr "Console"
-
msgid "Console Mode"
msgstr "Mode console"
@@ -706,9 +703,6 @@ msgstr "Quantité insuffisante"
msgid "Inventory adjustment completed"
msgstr "Ajustement de stock terminé"
-msgid "Inventory Adjustments"
-msgstr "Ajustements de stock"
-
msgid "is"
msgstr "est"
@@ -1111,9 +1105,6 @@ msgstr "Ouvrir une NCR pour le traitement du MRB"
msgid "Open Jobs"
msgstr "Ordres de fabrication ouverts"
-msgid "Operations"
-msgstr "Opérations"
-
msgid "Operations ended"
msgstr "Opérations terminées"
@@ -1687,9 +1678,6 @@ msgstr "Aujourd'hui"
msgid "Toggle the sidebar"
msgstr "Afficher/masquer la barre latérale"
-msgid "Tools"
-msgstr "Outils"
-
msgid "Total"
msgstr "Total"
diff --git a/packages/locale/locales/hi/mes.po b/packages/locale/locales/hi/mes.po
index 7da14a9d9f..de15dbf5ca 100644
--- a/packages/locale/locales/hi/mes.po
+++ b/packages/locale/locales/hi/mes.po
@@ -354,9 +354,6 @@ msgstr "पूर्ण हो रहा है"
msgid "Connecting"
msgstr "जुड़ रहा है"
-msgid "Console"
-msgstr "कंसोल"
-
msgid "Console Mode"
msgstr "कंसोल मोड"
@@ -706,9 +703,6 @@ msgstr "अपर्याप्त मात्रा"
msgid "Inventory adjustment completed"
msgstr "इन्वेंटरी समायोजन पूर्ण हुआ"
-msgid "Inventory Adjustments"
-msgstr "इन्वेंटरी समायोजन"
-
msgid "is"
msgstr "है"
@@ -1111,9 +1105,6 @@ msgstr "MRB निपटान के लिए एक NCR खोलें"
msgid "Open Jobs"
msgstr "खुली जॉब्स"
-msgid "Operations"
-msgstr "ऑपरेशन"
-
msgid "Operations ended"
msgstr "ऑपरेशन समाप्त"
@@ -1687,9 +1678,6 @@ msgstr "आज"
msgid "Toggle the sidebar"
msgstr "साइडबार को टॉगल करें"
-msgid "Tools"
-msgstr "उपकरण"
-
msgid "Total"
msgstr "कुल"
diff --git a/packages/locale/locales/it/mes.po b/packages/locale/locales/it/mes.po
index 0a416e95d6..a9584c800c 100644
--- a/packages/locale/locales/it/mes.po
+++ b/packages/locale/locales/it/mes.po
@@ -354,9 +354,6 @@ msgstr "Completamento in corso"
msgid "Connecting"
msgstr "Collegamento in corso"
-msgid "Console"
-msgstr "Console"
-
msgid "Console Mode"
msgstr "Modalità Console"
@@ -706,9 +703,6 @@ msgstr "Quantità insufficiente"
msgid "Inventory adjustment completed"
msgstr "Rettifica di magazzino completata"
-msgid "Inventory Adjustments"
-msgstr "Rettifiche di magazzino"
-
msgid "is"
msgstr "è"
@@ -1111,9 +1105,6 @@ msgstr "Apri un NCR per la disposizione MRB"
msgid "Open Jobs"
msgstr "Ordini di produzione aperti"
-msgid "Operations"
-msgstr "Operazioni"
-
msgid "Operations ended"
msgstr "Operazioni terminate"
@@ -1687,9 +1678,6 @@ msgstr "Oggi"
msgid "Toggle the sidebar"
msgstr "Attiva/disattiva la barra laterale"
-msgid "Tools"
-msgstr "Utensili"
-
msgid "Total"
msgstr "Totale"
diff --git a/packages/locale/locales/ja/mes.po b/packages/locale/locales/ja/mes.po
index 3daedc5410..0ea8573413 100644
--- a/packages/locale/locales/ja/mes.po
+++ b/packages/locale/locales/ja/mes.po
@@ -354,9 +354,6 @@ msgstr "完了処理中"
msgid "Connecting"
msgstr "接続中"
-msgid "Console"
-msgstr "コンソール"
-
msgid "Console Mode"
msgstr "コンソールモード"
@@ -706,9 +703,6 @@ msgstr "数量が不足しています"
msgid "Inventory adjustment completed"
msgstr "在庫調整が完了しました"
-msgid "Inventory Adjustments"
-msgstr "在庫調整"
-
msgid "is"
msgstr "が次と等しい"
@@ -1111,9 +1105,6 @@ msgstr "MRB処置のためにNCRを開く"
msgid "Open Jobs"
msgstr "オープンな製造指図"
-msgid "Operations"
-msgstr "工程"
-
msgid "Operations ended"
msgstr "工程が終了しました"
@@ -1687,9 +1678,6 @@ msgstr "今日"
msgid "Toggle the sidebar"
msgstr "サイドバーの表示/非表示を切り替える"
-msgid "Tools"
-msgstr "工具"
-
msgid "Total"
msgstr "合計"
diff --git a/packages/locale/locales/ko/mes.po b/packages/locale/locales/ko/mes.po
index c5aa6315fb..c6156a594d 100644
--- a/packages/locale/locales/ko/mes.po
+++ b/packages/locale/locales/ko/mes.po
@@ -354,9 +354,6 @@ msgstr "완료 처리 중"
msgid "Connecting"
msgstr "연결 중"
-msgid "Console"
-msgstr "콘솔"
-
msgid "Console Mode"
msgstr "콘솔 모드"
@@ -706,9 +703,6 @@ msgstr "수량 부족"
msgid "Inventory adjustment completed"
msgstr "재고 조정이 완료되었습니다"
-msgid "Inventory Adjustments"
-msgstr "재고 조정"
-
msgid "is"
msgstr "같음"
@@ -1111,9 +1105,6 @@ msgstr "MRB 처분 결정을 위해 NCR을 여세요"
msgid "Open Jobs"
msgstr "작업 지시 열기"
-msgid "Operations"
-msgstr "공정작업"
-
msgid "Operations ended"
msgstr "공정작업 종료됨"
@@ -1687,9 +1678,6 @@ msgstr "오늘"
msgid "Toggle the sidebar"
msgstr "사이드바 전환"
-msgid "Tools"
-msgstr "공구"
-
msgid "Total"
msgstr "총계"
diff --git a/packages/locale/locales/pl/mes.po b/packages/locale/locales/pl/mes.po
index c1a63de87d..242fb0f73d 100644
--- a/packages/locale/locales/pl/mes.po
+++ b/packages/locale/locales/pl/mes.po
@@ -354,9 +354,6 @@ msgstr "Finalizowanie"
msgid "Connecting"
msgstr "Łączenie"
-msgid "Console"
-msgstr "Konsola"
-
msgid "Console Mode"
msgstr "Tryb konsoli"
@@ -706,9 +703,6 @@ msgstr "Niewystarczająca ilość"
msgid "Inventory adjustment completed"
msgstr "Korekta zapasów zakończona"
-msgid "Inventory Adjustments"
-msgstr "Korekty zapasów"
-
msgid "is"
msgstr "jest"
@@ -1111,9 +1105,6 @@ msgstr "Otwórz NCR dla dyspozycji MRB"
msgid "Open Jobs"
msgstr "Otwarte zlecenia produkcyjne"
-msgid "Operations"
-msgstr "Operacje"
-
msgid "Operations ended"
msgstr "Operacje zakończone"
@@ -1687,9 +1678,6 @@ msgstr "Dzisiaj"
msgid "Toggle the sidebar"
msgstr "Przełącz pasek boczny"
-msgid "Tools"
-msgstr "Narzędzia"
-
msgid "Total"
msgstr "Suma"
diff --git a/packages/locale/locales/pt/mes.po b/packages/locale/locales/pt/mes.po
index b6c3dba565..18a6aa82b4 100644
--- a/packages/locale/locales/pt/mes.po
+++ b/packages/locale/locales/pt/mes.po
@@ -354,9 +354,6 @@ msgstr "Concluindo"
msgid "Connecting"
msgstr "Conectando"
-msgid "Console"
-msgstr "Console"
-
msgid "Console Mode"
msgstr "Modo Console"
@@ -706,9 +703,6 @@ msgstr "Quantidade insuficiente"
msgid "Inventory adjustment completed"
msgstr "Ajuste de estoque concluído"
-msgid "Inventory Adjustments"
-msgstr "Ajustes de Estoque"
-
msgid "is"
msgstr "é"
@@ -1111,9 +1105,6 @@ msgstr "Abrir um NCR para disposição MRB"
msgid "Open Jobs"
msgstr "Ordens de produção abertas"
-msgid "Operations"
-msgstr "Operações"
-
msgid "Operations ended"
msgstr "Operações encerradas"
@@ -1687,9 +1678,6 @@ msgstr "Hoje"
msgid "Toggle the sidebar"
msgstr "Alternar barra lateral"
-msgid "Tools"
-msgstr "Ferramentas"
-
msgid "Total"
msgstr "Total"
diff --git a/packages/locale/locales/ru/mes.po b/packages/locale/locales/ru/mes.po
index bd15e24369..bfea764a71 100644
--- a/packages/locale/locales/ru/mes.po
+++ b/packages/locale/locales/ru/mes.po
@@ -354,9 +354,6 @@ msgstr "Завершение"
msgid "Connecting"
msgstr "Подключение"
-msgid "Console"
-msgstr "Консоль"
-
msgid "Console Mode"
msgstr "Режим консоли"
@@ -706,9 +703,6 @@ msgstr "Недостаточное количество"
msgid "Inventory adjustment completed"
msgstr "Корректировка запасов выполнена"
-msgid "Inventory Adjustments"
-msgstr "Корректировка запасов"
-
msgid "is"
msgstr "равно"
@@ -1111,9 +1105,6 @@ msgstr "Открыть NCR для решения MRB"
msgid "Open Jobs"
msgstr "Открытые производственные заказы"
-msgid "Operations"
-msgstr "Операции"
-
msgid "Operations ended"
msgstr "Операции завершены"
@@ -1687,9 +1678,6 @@ msgstr "Сегодня"
msgid "Toggle the sidebar"
msgstr "Открыть/закрыть боковую панель"
-msgid "Tools"
-msgstr "Инструменты"
-
msgid "Total"
msgstr "Итого"
diff --git a/packages/locale/locales/tr/mes.po b/packages/locale/locales/tr/mes.po
index 061671f714..4bd2f4415b 100644
--- a/packages/locale/locales/tr/mes.po
+++ b/packages/locale/locales/tr/mes.po
@@ -354,9 +354,6 @@ msgstr "Tamamlanıyor"
msgid "Connecting"
msgstr "Bağlanıyor"
-msgid "Console"
-msgstr "Konsol"
-
msgid "Console Mode"
msgstr "Konsol Modu"
@@ -706,9 +703,6 @@ msgstr "Yetersiz miktar"
msgid "Inventory adjustment completed"
msgstr "Stok düzeltme tamamlandı"
-msgid "Inventory Adjustments"
-msgstr "Stok düzeltmeleri"
-
msgid "is"
msgstr "eşittir"
@@ -1111,9 +1105,6 @@ msgstr "MRB kararı için NCR aç"
msgid "Open Jobs"
msgstr "Açık İş emirleri"
-msgid "Operations"
-msgstr "Operasyonlar"
-
msgid "Operations ended"
msgstr "Operasyonlar bitti"
@@ -1687,9 +1678,6 @@ msgstr "Bugün"
msgid "Toggle the sidebar"
msgstr "Kenar çubuğunu aç/kapat"
-msgid "Tools"
-msgstr "Araçlar"
-
msgid "Total"
msgstr "Toplam"
diff --git a/packages/locale/locales/zh/mes.po b/packages/locale/locales/zh/mes.po
index b48a2125ed..0383a977d2 100644
--- a/packages/locale/locales/zh/mes.po
+++ b/packages/locale/locales/zh/mes.po
@@ -354,9 +354,6 @@ msgstr "完成中"
msgid "Connecting"
msgstr "连接中"
-msgid "Console"
-msgstr "控制台"
-
msgid "Console Mode"
msgstr "控制台模式"
@@ -706,9 +703,6 @@ msgstr "数量不足"
msgid "Inventory adjustment completed"
msgstr "库存调整已完成"
-msgid "Inventory Adjustments"
-msgstr "库存调整"
-
msgid "is"
msgstr "是"
@@ -1111,9 +1105,6 @@ msgstr "为MRB处置打开NCR"
msgid "Open Jobs"
msgstr "未结工单"
-msgid "Operations"
-msgstr "工序"
-
msgid "Operations ended"
msgstr "工序已结束"
@@ -1687,9 +1678,6 @@ msgstr "今天"
msgid "Toggle the sidebar"
msgstr "切换侧栏"
-msgid "Tools"
-msgstr "工具"
-
msgid "Total"
msgstr "总计"
diff --git a/packages/react/AGENTS.md b/packages/react/AGENTS.md
index 763e8ec7cf..5b37816280 100644
--- a/packages/react/AGENTS.md
+++ b/packages/react/AGENTS.md
@@ -41,6 +41,7 @@ import { Button, Card, HStack, VStack, IconButton, cn } from "@carbon/react";
- **Choice screens**: `ChoiceCardGroup` (card radios, `autoFocus` focuses the selected card) and `RadioGroupButton` (radio styled as a secondary Button) give one tab stop + arrow-key select; Enter stays free for the screen's continue action
- **Layout**: `VStack` / `HStack` with numeric `spacing` prop (maps to `space-y-*`/`space-x-*`)
- **Overlays**: `Drawer`, `Modal`, `ModalDrawer` (unified drawer/modal), `BottomSheet`, `Popover`
+- **App nav**: `NavRail` is the primary left nav of both the ERP and MES shells (56px icon rail, expands on mouse hover or when pinned via `SidebarProvider`/⌘B, left drawer below md that closes itself on navigation). Entries are `NavRailItem` (a button, or `asChild` for a trigger/link) and `NavRailLink`; `label` is a string and doubles as the accessible name. Render inside `SidebarProvider`; the shadcn-style `Sidebar*` primitives remain for other layouts
- **Data**: `Table` (TanStack), chart components via sub-exports (`@carbon/react/Chart`)
- **Rich text**: `@carbon/react/Editor` and `@carbon/react/RichText` (wraps `@carbon/tiptap`)
- **Error boundary**: `@carbon/react/ErrorBoundary` — `RootErrorBoundary` (drop-in root `ErrorBoundary` for RR v7 that maps 404 / other HTTP / thrown `Error` to a styled screen) plus its parts (`ErrorScreen`, `GlitchHeading`, `StatusReadout`, `MagneticLink`, `NoiseOverlay`). Wrap it in the app's `Document` and pass `env` so `window.env` is set (the client crashes hydration otherwise). Copy is intentionally hardcoded English, not i18n.
diff --git a/packages/react/src/NavRail.tsx b/packages/react/src/NavRail.tsx
new file mode 100644
index 0000000000..34c202763e
--- /dev/null
+++ b/packages/react/src/NavRail.tsx
@@ -0,0 +1,262 @@
+"use client";
+
+import { Trans } from "@lingui/react/macro";
+import { Slot, Slottable } from "@radix-ui/react-slot";
+import type { ButtonHTMLAttributes, ReactNode } from "react";
+import { forwardRef, useEffect, useState } from "react";
+import type { LinkProps } from "react-router";
+import { Link, useLocation } from "react-router";
+import { Drawer, DrawerContent, DrawerTitle } from "./Drawer";
+import { Separator } from "./Separator";
+import { useSidebar } from "./Sidebar";
+import { cn } from "./utils/cn";
+import { VStack } from "./VStack";
+
+export const navRailItemClasses = [
+ "relative text-foreground/70 hover:text-foreground",
+ "h-10 w-10 group-data-[state=expanded]:w-full",
+ "flex items-center rounded-md",
+ "group-data-[state=collapsed]:justify-center",
+ "group-data-[state=expanded]:-space-x-2",
+ "font-medium shrink-0 inline-flex items-center justify-center select-none",
+ "disabled:opacity-50",
+ "transition-[background-color,color,width] duration-100 ease-out",
+ "focus:!outline-none focus:!ring-0 active:!outline-none active:!ring-0",
+ "after:pointer-events-none after:absolute after:-inset-[3px] after:rounded-lg after:border after:border-blue-500 after:opacity-0 after:ring-2 after:ring-blue-500/20 after:transition-opacity focus-visible:after:opacity-100 active:after:opacity-0",
+ "group/item"
+];
+
+/**
+ * The primary left navigation shared by the ERP and MES app shells: a 56px
+ * icon rail that grows to 208px while a mouse hovers it or while it is pinned
+ * open (⌘B / a `SidebarTrigger`), and a left drawer below `md`. Open state
+ * comes from `SidebarProvider`, so it must be rendered inside one.
+ */
+export function NavRail({
+ children,
+ footer,
+ forceExpanded = false,
+ disableHover = false
+}: {
+ children: ReactNode;
+ footer?: ReactNode;
+ /** Hold the rail open regardless of hover or pin (e.g. while rearranging). */
+ forceExpanded?: boolean;
+ /** Ignore hover, e.g. while a modal owns the pointer. */
+ disableHover?: boolean;
+}) {
+ const { open, isMobile, openMobile, setOpenMobile } = useSidebar();
+ const { pathname } = useLocation();
+ const [hovered, setHovered] = useState(false);
+
+ // Links, go-to shortcuts and redirects all land here: whatever navigated,
+ // the phone drawer must not stay over the destination.
+ // biome-ignore lint/correctness/useExhaustiveDependencies: runs per navigation
+ useEffect(() => {
+ setOpenMobile(false);
+ }, [pathname, setOpenMobile]);
+
+ // A Radix dialog toggles document.body pointer-events, and restoring them on
+ // close fires a phantom enter on the rail with no paired leave — leaving it
+ // stuck expanded. So hover is ignored while `disableHover` is set and cleared
+ // on the frame after it changes (after any phantom event has fired).
+ // biome-ignore lint/correctness/useExhaustiveDependencies: keyed on the toggle
+ useEffect(() => {
+ const raf = requestAnimationFrame(() => setHovered(false));
+ return () => cancelAnimationFrame(raf);
+ }, [disableHover]);
+
+ const content = (
+ <VStack spacing={1} className="flex flex-col justify-between h-full px-2">
+ <VStack spacing={1}>{children}</VStack>
+ {footer ? <VStack spacing={1}>{footer}</VStack> : null}
+ </VStack>
+ );
+
+ if (isMobile) {
+ return (
+ <Drawer open={openMobile} onOpenChange={setOpenMobile}>
+ <DrawerContent
+ position="left"
+ size="content"
+ className="w-[17rem] max-w-[85vw] p-0"
+ >
+ <DrawerTitle className="px-6 py-4">
+ <Trans>Navigation</Trans>
+ </DrawerTitle>
+ <nav
+ data-state="expanded"
+ className="group flex-1 overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-accent pb-4"
+ >
+ {content}
+ </nav>
+ </DrawerContent>
+ </Drawer>
+ );
+ }
+
+ const state = forceExpanded || open || hovered ? "expanded" : "collapsed";
+
+ return (
+ // The wrapper (not just the inner nav) grows on expand, so the rail pushes
+ // the rest of the layout right instead of floating over it. Sticky so it
+ // stays in view in shells whose page scrolls as a whole.
+ <div
+ data-state={state}
+ className={cn(
+ "sticky top-0 h-svh flex-col z-50 hidden md:flex shrink-0",
+ "w-14 data-[state=expanded]:w-[13rem]",
+ "transition-[width] duration-200"
+ )}
+ >
+ <nav
+ data-state={state}
+ className={cn(
+ "bg-background py-2 group z-10 h-full w-full",
+ "flex flex-col justify-between",
+ "hide-scrollbar overflow-y-auto scrollbar-thin scrollbar-track-transparent scrollbar-thumb-accent"
+ )}
+ onPointerEnter={(event) => {
+ // Mouse only: a tap on a touch tablet must not expand the rail.
+ if (!disableHover && event.pointerType === "mouse") setHovered(true);
+ }}
+ onPointerLeave={(event) => {
+ if (event.pointerType === "mouse") setHovered(false);
+ }}
+ >
+ {content}
+ </nav>
+ </div>
+ );
+}
+
+type NavRailItemProps = Omit<
+ ButtonHTMLAttributes<HTMLButtonElement>,
+ "children"
+> & {
+ icon: ReactNode;
+ /** Also the accessible name; the visible label span is aria-hidden. */
+ label: string;
+ isActive?: boolean;
+ tag?: ReactNode;
+ /** Shown at the right edge only while expanded (e.g. a shortcut hint). */
+ trailing?: ReactNode;
+ asChild?: boolean;
+ children?: ReactNode;
+};
+
+/**
+ * One rail entry. A `<button>` by default; with `asChild` the child element
+ * becomes the item, so a `Link` or a Radix trigger keeps its own semantics.
+ */
+export const NavRailItem = forwardRef<HTMLButtonElement, NavRailItemProps>(
+ (
+ {
+ icon,
+ label,
+ isActive = false,
+ tag,
+ trailing,
+ asChild = false,
+ className,
+ children,
+ ...props
+ },
+ ref
+ ) => {
+ const Comp = asChild ? Slot : "button";
+
+ return (
+ <Comp
+ ref={ref}
+ type={asChild ? undefined : "button"}
+ aria-label={label}
+ {...props}
+ className={cn(
+ navRailItemClasses,
+ isActive
+ ? "bg-active text-active-foreground dark:shadow-button-base"
+ : "hover:bg-active/60 hover:text-active-foreground",
+ className
+ )}
+ >
+ {/* A 16px icon centred in this 24px box sits where a `left-3 top-3`
+ icon would; the box also fits an `Avatar size="xs"`. */}
+ <span className="absolute left-2 top-2 flex size-6 items-center justify-center [&>svg]:size-4">
+ {icon}
+ </span>
+ {tag ? (
+ <span className="absolute top-1 right-1 min-w-4 h-4 px-1 rounded-full bg-primary text-primary-foreground text-[10px] font-medium leading-4 text-center tabular-nums">
+ {tag}
+ </span>
+ ) : null}
+ <span
+ aria-hidden
+ className={cn(
+ "min-w-[128px] text-sm text-left",
+ "absolute left-7 group-data-[state=expanded]:left-12",
+ "opacity-0 group-data-[state=expanded]:opacity-100"
+ )}
+ >
+ {label}
+ </span>
+ {trailing ? (
+ <span
+ className={cn(
+ "pointer-events-none absolute right-3 top-1/2 -translate-y-1/2",
+ "opacity-0 transition-opacity duration-100 group-data-[state=expanded]:opacity-100"
+ )}
+ >
+ {trailing}
+ </span>
+ ) : null}
+ <Slottable>{children}</Slottable>
+ </Comp>
+ );
+ }
+);
+NavRailItem.displayName = "NavRailItem";
+
+export function NavRailLink({
+ to,
+ icon,
+ label,
+ isActive = false,
+ tag,
+ external = false,
+ target,
+ rel
+}: {
+ to: string;
+ icon: ReactNode;
+ label: string;
+ isActive?: boolean;
+ tag?: ReactNode;
+ external?: boolean;
+ target?: LinkProps["target"];
+ rel?: string;
+}) {
+ return (
+ <NavRailItem
+ asChild
+ icon={icon}
+ label={label}
+ isActive={isActive}
+ tag={tag}
+ >
+ <Link
+ to={to}
+ target={target}
+ rel={rel}
+ aria-current={isActive ? "page" : undefined}
+ prefetch={external ? "none" : "intent"}
+ />
+ </NavRailItem>
+ );
+}
+
+export function NavRailDivider() {
+ return (
+ <Separator className="my-1 mx-auto w-6 group-data-[state=expanded]:w-full transition-[width] duration-200" />
+ );
+}
diff --git a/packages/react/src/index.tsx b/packages/react/src/index.tsx
index f71cee0016..709d2da7dd 100644
--- a/packages/react/src/index.tsx
+++ b/packages/react/src/index.tsx
@@ -239,6 +239,13 @@ import {
} from "./ModalDrawer";
import type { MultiSelectProps } from "./MultiSelect";
import { MultiSelect } from "./MultiSelect";
+import {
+ NavRail,
+ NavRailDivider,
+ NavRailItem,
+ NavRailLink,
+ navRailItemClasses
+} from "./NavRail";
import type { NumberFieldProps } from "./Number";
import {
NumberDecrementStepper,
@@ -546,6 +553,11 @@ export {
NumberDecrementStepper,
NumberField,
NumberIncrementStepper,
+ NavRail,
+ NavRailDivider,
+ NavRailItem,
+ NavRailLink,
+ navRailItemClasses,
NumberInput,
NumberInputGroup,
NumberInputStepper,