Navigation
Configure page tree and sidebar navigation
Navigation
fromsrc uses a file-based navigation system. Your docs folder structure determines the sidebar navigation.
Folder structure
Meta files
Use _meta.json files to control page ordering and section titles.
Pages are displayed in the order specified. Pages not listed appear after the specified pages.
Nested sections
Create _meta.json in subdirectories for nested navigation:
Frontmatter ordering
Alternatively, use frontmatter order to sort pages:
Lower numbers appear first. Pages without order default to 99.
Sidebar sections
The sidebar groups pages from the navigation tree:
- Top-level pages stay in one root section
- Nested pages are grouped by their first folder
- Section titles come from folder
_meta.jsontitlewhen present
Custom sections
You can fully customize section grouping in your own sidebar component:
Icons
Add icons to sidebar items via the icons map:
Collapsible folders
Folders can be collapsed in the sidebar. Use defaultOpen to control initial state:
Use defaultOpenLevel on the Sidebar component to auto-expand folders to a certain depth: