Sidebar Filter

How the real-time sidebar filter works and how to configure it.

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:

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

To explicitly enable it:

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; 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.