Standard Navigation
Sidebar Nav with Collapsible Groups
App sidebar organised into collapsible sections, each holding its own links. Highlights the active route, auto-opens the section a deep link lands in, and keeps every other section's open/closed state exactly as the user left it across route changes.
$ velocityx add standard-sidebar-nav
Built for react.
Needs react already installed
as a peer dependency.
An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.
Full docs for Sidebar Nav with Collapsible Groups →
Needs a licence key —
subscribe here, then
velocityx loginonce.
Props
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| groups | { id: string, label: string, items: { id: string, label: string, href: string, icon?: ReactNode }[] }[] | No | [] | |
| currentHref | string | Yes | the active route, drives aria-current + highlight | |
| defaultOpenIds | string[] | Yes | section ids open on first render, default: all | |
| persistKey | string | Yes | localStorage key; omit to keep state in memory only | |
| label | string | No | 'Sidebar' | accessible name for the <nav> |
| className | string | No | '' |
File this creates
The CLI writes this path into your project, relative to its root — nothing else moves.
components/velocity/standard-sidebar-nav/SidebarNavGroups.jsxUsing the Sidebar Nav with Collapsible Groups component
Install it with velocityx add standard-sidebar-nav.
The CLI writes the source straight into your project — no runtime dependency, no registry
lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.
Related components
More from Standard Navigation.
In-page section links that highlight themselves as the reader scrolls, so a long docs or landing page always shows where you are without you having to hunt for it. Tracks visibility with IntersectionObserver, never a scroll handler, so it costs nothing on long pages.
reactA 'waffle' product switcher popover for suites that have grown past one nav bar into several standalone apps — a grid of icon tiles for every section, the current one marked, fully arrow-key navigable and closes cleanly on outside click or route change.
reactHeader for a drill-down screen: a real back link to the parent (not a history hack), the page title and optional subtitle, and an overflow menu for secondary actions that don't need a permanent button.
reactWayfinding trail for deep page hierarchies that collapses middle segments behind an ellipsis on narrow screens, keeping the root and current page always visible, with the current page shown as text rather than a dead link.
react