VitePress Sidebar
A VitePress plugin that builds the sidebar from the files on disk. Sorting, titles, filters and per-folder settings replace a menu kept up to date by hand.
About this project
VitePress Sidebar builds the sidebar of a VitePress site from the folder tree, so a documentation site stops carrying a hand-written menu that has to be edited every time a page is added, renamed or moved. It wraps the VitePress configuration with one function call and leaves everything else in place.
The generated menu is configurable rather than fixed. Titles can be read from the file heading or the frontmatter, folders can be sorted, collapsed to a chosen depth, filtered, renamed or excluded, and a folder can carry a configuration file of its own where it has to differ from the rest. Multiple sidebars and frontmatter overrides work the way VitePress documents them, so nothing the default theme already does is taken away.
It is written in TypeScript, ships its own declarations, adds a small amount to the build and nothing at all to the page, and tracks the current VitePress release. Every option is documented with an example.
Features
Documentation site
TypeScript types
Multiple languages
Verified by tests