Skip to content

aryacahil/sidebar_menu

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.) πŸš€

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors