Sidebar Customization¶

Customize the Bambuddy sidebar by showing or hiding built-in pages, reordering navigation items, and adding custom links to external tools and resources.

:material-sidebar: Overview¶

Sidebar customization lets you:

• Keep your most-used Bambuddy pages near the top
• Hide built-in pages you do not use often
• Add one-click links to Spoolman, OctoPrint, Grafana, and other tools
• Set a default sidebar layout for other users

Built-in Pages¶

Built-in Bambuddy pages can be shown, hidden, and reordered from the sidebar settings.

1. Go to Settings > General
2. Open the Sidebar pane
3. Toggle pages on or off
4. Drag visible pages into your preferred order

Hidden pages are removed from the sidebar navigation. Use this to keep the sidebar focused on the pages you use day to day.

Hidden pages remain accessible by direct URL and from any in-app links that point to them. Settings cannot be hidden, so you can always return to the sidebar settings and show pages again.

External Links¶

External links add custom sidebar entries for tools and resources outside Bambuddy.

Adding a Link¶

1. Go to Settings > External Links
2. Click Add Link
3. Fill in the details:

1. Click Save

Editing¶

1. Click the edit icon on a link
2. Modify any field
3. Click Save

Deleting¶

1. Click the delete icon
2. Confirm deletion

Icons¶

Choose from Material Design icons:

Additional icons available in the icon picker.

Ordering and Visibility¶

Reordering¶

Built-in pages and external links can be reordered together from the sidebar settings.

1. Go to Settings > General
2. Open the Sidebar pane
3. Drag an item to a new position
4. Release to save the new order

Visibility¶

Use sidebar visibility controls to decide what appears in navigation:

• Built-in pages can be shown or hidden from the sidebar settings
• Settings is always visible and cannot be hidden
• Hidden built-in pages stay available by direct URL and from in-app links
• External links cannot be hidden; delete an external link to remove it from the sidebar

External Link Appearance¶

External links display with:

• Icon (if selected)
• Name
• External indicator (if opens new tab)

Use Cases¶

Spoolman¶

Link to your filament inventory:

OctoPrint / Mainsail¶

Link to printer web interfaces:

Grafana Dashboard¶

Link to monitoring dashboards:

Documentation¶

Link to manuals or wikis:

Printables / Thingiverse¶

Quick access to model sites:

Admin Default Sidebar Order¶

Admins can set a default sidebar navigation layout that applies to users who have not customized their own sidebar. The default captures the saved order for built-in pages and external links, plus the visibility state for built-in pages.

Setting a Default¶

1. Arrange sidebar items in your preferred order
2. Show or hide the built-in pages you want included
3. Go to Settings > General > Sidebar Order
4. Toggle Set Default on

The current sidebar layout is saved as the default for all users.

How It Works¶

Keyboard Shortcuts¶

Visible sidebar entries can be accessed via keyboard:

• Sidebar items are assigned number shortcuts
• Press the assigned number to navigate

Backup Integration¶

Sidebar customization is included in backups:

• External links are exported with database backups
• Sidebar order and built-in page visibility settings are restored when importing a backup
• No manual re-entry needed after restore

Backup & Restore

Tips¶