## Overview

The sidebar filter is a text input at the top of the sidebar that filters navigation items in real time as you type. It helps users quickly find pages in large documentation sites without scrolling through the full sidebar tree.

The sidebar filter is enabled by default in projects created with `create-zudo-doc`.

## How It Works

The filter input appears at the top of the sidebar, above the navigation tree. As you type:

- Both category names and individual page titles are matched against your query
- Matching is case-insensitive
- When a category name matches, all of its child pages are shown
- When only child pages match, the parent category is shown with just the matching children
- All matching categories are automatically expanded during filtering
- Clearing the input restores the full sidebar tree

## Keyboard Shortcut

Press `Ctrl+/` (Windows/Linux) or `Cmd+/` (macOS) to focus the filter input from anywhere on the page. This works when the sidebar is visible (desktop viewport or mobile sidebar open).

## Enabling or Disabling

### With create-zudo-doc

The sidebar filter is on by default. To disable it during project creation:

```bash
pnpm create zudo-doc my-docs --no-sidebar-filter
```

To explicitly enable it:

```bash
pnpm create zudo-doc my-docs --sidebar-filter
```

### In an Existing Project

Use the `sidebarFilter` feature/configuration to disable the filter. For a new project, pass `--no-sidebar-filter` or leave `sidebarFilter` out of the selected features. For markup changes, replace the primary `Sidebar` through [`chromeBindingsModule`](https://zudo-doc.takazudomodular.com/docs/reference/host-chrome-bindings); if you eject nested sidebar pieces, follow the CLI's owner-level remediation because copying a child island alone does not replace the package sidebar.

[Dynamic content unavailable in text export]

For most documentation sites, the sidebar filter is useful even with a small number of pages. It becomes essential as your content grows beyond a few dozen pages.