From f710da707ef326d65b5fecdfbe680a9c5306afb3 Mon Sep 17 00:00:00 2001 From: Adeel Ahmad Date: Thu, 15 Oct 2026 10:26:22 +0000 Subject: [PATCH 1/2] feat(nav): name the navigation's groups The nav rail's 18 items sit in four groups, each named above its first item: what people use every day, Explore (Entities, Topics, Graph, Podcasts, Reports), Automate (Pipelines, Routines, Extensions, Sensors or Sources) and Manage (Costs, Analytics, Settings, Admin). Costs moves from the first group to Manage. Collapsed to icons, the names are lines. Items are 32px rather than 34px, so the names add about 20px to the rail. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_012QHdEu9xFwnsCUnJn4yB3v --- docs/frontend.md | 8 ++++ nextjs-frontend/__tests__/nav-groups.test.tsx | 31 +++++++++++++ nextjs-frontend/__tests__/navigation.test.ts | 14 ++++++ .../components/app-shell/nav-config.ts | 46 ++++++++++--------- nextjs-frontend/components/app-shell/nav.tsx | 15 ++++-- 5 files changed, 90 insertions(+), 24 deletions(-) create mode 100644 nextjs-frontend/__tests__/nav-groups.test.tsx diff --git a/docs/frontend.md b/docs/frontend.md index f52569b44..bb22efac8 100644 --- a/docs/frontend.md +++ b/docs/frontend.md @@ -34,6 +34,14 @@ nextjs-frontend/ app/openapi-client/ generated from the API's OpenAPI schema; never edit by hand ``` +## Navigation + +The nav rail (`components/app-shell/nav-config.ts`) is in four groups, each named above its first item (a line when +the rail is collapsed to icons): what people use every day (Home, Library, Search, Chat, Notes), **Explore** what Lens +found (Entities, Topics, Graph, Podcasts, Reports), **Automate** what runs by itself (Pipelines, Routines, Extensions, +Sensors, or Sources for people who aren't admins), and **Manage** Lens (Costs, Analytics, Settings, Admin). Every page +stays one click from Home; ⌘K reaches every page, recording and setting by name. + ## Design system Colour is semantic, never decorative: blue means working, selected or a link; green means ready or succeeded; red diff --git a/nextjs-frontend/__tests__/nav-groups.test.tsx b/nextjs-frontend/__tests__/nav-groups.test.tsx new file mode 100644 index 000000000..03dd5397d --- /dev/null +++ b/nextjs-frontend/__tests__/nav-groups.test.tsx @@ -0,0 +1,31 @@ +import { render, screen } from "@testing-library/react"; +import "@testing-library/jest-dom"; + +import { Nav } from "@/components/app-shell/nav"; +import { TooltipProvider } from "@/components/ui/tooltip"; + +jest.mock("next/navigation", () => ({ usePathname: () => "/settings/llm" })); +jest.mock("@/components/notes/notes-tree", () => ({ NotesTree: () => null })); + +const nav = (collapsed: boolean) => + render( + +