Skip to content
Β 
Β 

Repository files navigation

πŸ“š Sidebar Menu for Frappe

A modern and flexible Sidebar Menu Builder for Frappe/ERPNext. This app lets you create a custom global sidebar menu with drag-and-drop, category grouping, and visibility toggling β€” fully independent from Workspace.


✨ Features

  • πŸ”§ Drag & Drop Menu Builder (powered by SortableJS)
  • πŸ—‚οΈ Category Support: Group menu items into collapsible sections
  • 🧩 Support for Links: Doctype, Page, Report, Workspace, or Custom Link
  • πŸ‘οΈ Hide/Show Menu Items with a simple toggle
  • πŸ’Ύ Auto Save & Persistent Structure
  • πŸ–ΌοΈ Fully integrated UI with the look and feel of Frappe

πŸ–₯️ Preview

Screenshot 1

Screenshot 2


πŸš€ Installation

# Inside your bench directory:
bench get-app sidebar_menu https://github.com/aryacahil/sidebar_menu
bench --site your-site install-app sidebar_menu
bench build

πŸ› οΈ Usage

  1. Open Sidebar Menu Builder from the AwesomeBar or go to:
    /app/sidebar-menu-builder
  2. Drag & drop items from the Sidebar Menu Items panel into Menu Structure.
  3. Use the three-dot dropdown on each item to Edit, Hide, or Delete it.
  4. Click Save Structure to persist your changes.

You can also create new Sidebar Menu Items and Categories directly from the builder interface.


🧩 Doctypes

  • Sidebar Menu
    Represents each individual menu item.

  • Sidebar Menu Category
    Represents menu sections/groups (categories).

Supported Fields & Features

  • type: Link or Custom Link
  • link_type: Workspace, Doctype, Report, Page
  • link_to: The target name of the linked object
  • Visibility toggle (Show/Hide)
  • Drag-and-drop hierarchy (Parent/Category)

🎨 Tech Stack


πŸ“œ License

MIT License
Feel free to modify, use, and distribute this app within your Frappe-based projects.


πŸ’‘ Credits

  • Created by [Aryacahil]
  • Inspired by ERPNext's classic sidebar and modern UX needs.

About

πŸ”§ Customizable Sidebar Menu for Frappe ERPNext – inspired by Workspace, with drag-and-drop, category support, and dynamic links (DocType, Report, Page, etc.) πŸš€

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages