# SideNav

Grouped destinations with the current place held in focus.

- Family: Navigation, imported from `mizu-ui` or `mizu-ui/navigation`
- Docs: https://mizu.user64bit.world/components/side-nav
- Source: https://github.com/0xuser64bit/mizu/blob/main/packages/mizu/src/navigation/Navigation.tsx

## Usage

```tsx
import { SideNav } from "mizu-ui";

export function Example() {
  return (
    <SideNav
      currentPath="/components"
      groups={[
        {
          label: "Discover",
          items: [
            { label: "Collection", href: "/components" },
            { label: "Getting started", href: "/components/getting-started" },
          ],
        },
        {
          label: "Experiment",
          items: [
            { label: "Lab", href: "/lab" },
            { label: "Studio", href: "/studio" },
          ],
        },
      ]}
    />
  );
}
```

## Copy it with the shadcn CLI

```sh
npx shadcn@latest init 0xuser64bit/mizu/preset # once, where there is no components.json
npx shadcn@latest add 0xuser64bit/mizu/side-nav
```

## Props

- `groups`: `{label: string; items: NavigationItem[]}[]`. Named groups with native links.
- `currentPath`: `string`. Exact href of the current page.
- `label`: `string`. Navigation landmark.

## Accessibility

Real anchors and aria-current page. Decorative icons are hidden; link labels stay visible.

## Motion

CSS transitions explain state changes. Reduced motion removes travel.