# Sidebar 01

> A simple sidebar with navigation grouped by section.

A shadcn/ui block from the [@iandefined](https://ui.iandefined.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/iandefined/sidebar-01).

- Page, with a live preview: https://shadcn.exchange/r/iandefined/sidebar-01
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/iandefined/sidebar-01-light-4fb32cf928b5a59d.png
- Registry item: https://ui.iandefined.com/r/sidebar-01.json
- Categories: sidebar
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://ui.iandefined.com/r/sidebar-01.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `lucide-react`
- Registry items: `https://ui.shadcn.com/r/styles/base-luma/sidebar.json`, `https://ui.iandefined.com/r/breadcrumbs.json`, `https://ui.iandefined.com/r/separator.json`, `https://ui.iandefined.com/r/label.json`, `https://ui.iandefined.com/r/dropdown-menu.json`

## Files

### `src/registry/base/blocks/sidebar/01/page.tsx`

```tsx
import { AppSidebar } from "@/components/app-sidebar";
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumbs";
import { Separator } from "@/components/ui/separator";
import {
  SidebarInset,
  SidebarProvider,
  SidebarTrigger,
} from "@/components/ui/sidebar";

export default function Sidebar01Page() {
  return (
    <SidebarProvider>
      <AppSidebar />
      <SidebarInset>
        <header className="flex h-16 shrink-0 items-center gap-2 border-b px-4">
          <SidebarTrigger className="-ml-1" />
          <Separator
            orientation="vertical"
            className="mr-2 data-[orientation=vertical]:h-4"
          />
          <Breadcrumb>
            <BreadcrumbList>
              <BreadcrumbItem className="hidden md:block">
                <BreadcrumbLink href="/docs">
                  Build Your Application
                </BreadcrumbLink>
              </BreadcrumbItem>
              <BreadcrumbSeparator className="hidden md:block" />
              <BreadcrumbItem>
                <BreadcrumbPage>Data Fetching</BreadcrumbPage>
              </BreadcrumbItem>
            </BreadcrumbList>
          </Breadcrumb>
        </header>
        <div className="flex flex-1 flex-col gap-4 p-4">
          <div className="grid auto-rows-min gap-4 md:grid-cols-3">
            <div className="aspect-video rounded-xl bg-muted/50" />
            <div className="aspect-video rounded-xl bg-muted/50" />
            <div className="aspect-video rounded-xl bg-muted/50" />
          </div>
          <div className="min-h-[100vh] flex-1 rounded-xl bg-muted/50 md:min-h-min" />
        </div>
      </SidebarInset>
    </SidebarProvider>
  );
}
```

### `src/registry/base/blocks/sidebar/01/components/app-sidebar.tsx`

```tsx
import * as React from "react";

import {
  Sidebar,
  SidebarContent,
  SidebarGroup,
  SidebarGroupContent,
  SidebarGroupLabel,
  SidebarHeader,
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
  SidebarRail,
} from "@/components/ui/sidebar";

import { SearchForm } from "./search-form";
import { VersionSwitcher } from "./version-switcher";

const data = {
  versions: ["1.0.1", "1.1.0-alpha", "2.0.0-beta1"],
  navMain: [
    {
      title: "Getting Started",
      url: "#",
      items: [
        {
          title: "Installation",
          url: "/docs/installation",
        },
        {
          title: "Project Structure",
          url: "/docs/extending",
        },
      ],
    },
    {
      title: "Build Your Application",
      url: "#",
      items: [
        {
          title: "Routing",
          url: "/docs",
        },
        {
          title: "Data Fetching",
          url: "/blocks/sidebar-01",
          isActive: true,
        },
        {
          title: "Rendering",
          url: "/blocks/sidebar-01/preview",
        },
        {
          title: "Caching",
          url: "/docs/llms",
        },
        {
          title: "Theming",
          url: "/docs/theming",
        },
        {
          title: "Optimizing",
          url: "/docs/components",
        },
        {
          title: "Configuring",
          url: "/docs/installation",
        },
        {
          title: "Testing",
          url: "/blocks?category=sidebar",
        },
        {
          title: "Authentication",
          url: "/blocks?category=sidebar",
        },
        {
          title: "Deploying",
          url: "/docs/extending",
        },
        {
          title: "Upgrading",
          url: "/docs/components/button",
        },
        {
          title: "Examples",
          url: "/blocks",
        },
      ],
    },
    {
      title: "API Reference",
      url: "#",
      items: [
        {
          title: "Components",
          url: "/docs/components",
        },
        {
          title: "File Conventions",
          url: "/docs/extending",
        },
        {
          title: "Functions",
          url: "/docs/llms",
        },
        {
          title: "next.config.js Options",
          url: "/docs/installation",
        },
        {
          title: "CLI",
          url: "/blocks",
        },
        {
          title: "Edge Runtime",
          url: "/docs/theming",
        },
      ],
    },
    {
      title: "Architecture",
      url: "#",
      items: [
        {
          title: "Accessibility",
          url: "/docs/components",
        },
        {
          title: "Fast Refresh",
          url: "/blocks/sidebar-01",
        },
        {
          title: "Next.js Compiler",
          url: "/docs/extending",
        },
        {
          title: "Supported Browsers",
          url: "/docs",
        },
        {
          title: "Turbopack",
          url: "/docs/installation",
        },
      ],
    },
  ],
};

export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
  return (
    <Sidebar {...props}>
      <SidebarHeader>
        <VersionSwitcher
          versions={data.versions}
          defaultVersion={data.versions[0]}
        />
        <SearchForm />
      </SidebarHeader>
      <SidebarContent>
        {data.navMain.map((item) => (
          <SidebarGroup key={item.title}>
            <SidebarGroupLabel>{item.title}</SidebarGroupLabel>
            <SidebarGroupContent>
              <SidebarMenu>
                {item.items.map((item) => (
                  <SidebarMenuItem key={item.title}>
                    <SidebarMenuButton
                      render={(props) => (
                        <a
                          {...props}
                          href={item.url}
                          target="_top"
                          aria-current={item.isActive ? "page" : undefined}
                        >
                          {props.children}
                        </a>
                      )}
                      isActive={item.isActive}
                    >
                      {item.title}
                    </SidebarMenuButton>
                  </SidebarMenuItem>
                ))}
              </SidebarMenu>
            </SidebarGroupContent>
          </SidebarGroup>
        ))}
      </SidebarContent>
      <SidebarRail />
    </Sidebar>
  );
}
```

### `src/registry/base/blocks/sidebar/01/components/search-form.tsx`

```tsx
import { SearchIcon } from "lucide-react";

import { Label } from "@/components/ui/label";
import {
  SidebarGroup,
  SidebarGroupContent,
  SidebarInput,
} from "@/components/ui/sidebar";

export function SearchForm({ ...props }: React.ComponentProps<"form">) {
  return (
    <form {...props}>
      <SidebarGroup className="py-0">
        <SidebarGroupContent className="relative">
          <Label htmlFor="search" className="sr-only">
            Search
          </Label>
          <SidebarInput
            id="search"
            placeholder="Search the docs..."
            className="pl-8"
          />
          <SearchIcon
            aria-hidden="true"
            className="pointer-events-none absolute top-1/2 left-2 size-4 -translate-y-1/2 opacity-50 select-none"
          />
        </SidebarGroupContent>
      </SidebarGroup>
    </form>
  );
}
```

### `src/registry/base/blocks/sidebar/01/components/version-switcher.tsx`

```tsx
"use client";

import {
  CheckIcon,
  ChevronsUpDownIcon,
  GalleryVerticalEndIcon,
} from "lucide-react";
import * as React from "react";

import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
import {
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
} from "@/components/ui/sidebar";

export function VersionSwitcher({
  versions,
  defaultVersion,
}: {
  versions: string[];
  defaultVersion: string;
}) {
  const [selectedVersion, setSelectedVersion] = React.useState(defaultVersion);

  return (
    <SidebarMenu>
      <SidebarMenuItem>
        <DropdownMenu>
          <DropdownMenuTrigger
            render={
              <SidebarMenuButton
                size="lg"
                className="data-popup-open:bg-sidebar-accent data-popup-open:text-sidebar-accent-foreground"
              />
            }
          >
            <div className="flex aspect-square size-8 items-center justify-center rounded-lg bg-sidebar-primary text-sidebar-primary-foreground">
              <GalleryVerticalEndIcon aria-hidden="true" className="size-4" />
            </div>
            <div className="flex flex-col gap-0.5 leading-none">
              <span className="font-medium">Documentation</span>
              <span>v{selectedVersion}</span>
            </div>
            <ChevronsUpDownIcon aria-hidden="true" className="ml-auto" />
          </DropdownMenuTrigger>
          <DropdownMenuContent className="w-(--anchor-width)" align="start">
            {versions.map((version) => (
              <DropdownMenuItem
                key={version}
                onClick={() => setSelectedVersion(version)}
              >
                v{version}{" "}
                {version === selectedVersion && (
                  <CheckIcon aria-hidden="true" className="ml-auto" />
                )}
              </DropdownMenuItem>
            ))}
          </DropdownMenuContent>
        </DropdownMenu>
      </SidebarMenuItem>
    </SidebarMenu>
  );
}
```