Skip to Content

React Sidebar Navigation

by
Odoo
v 19.0 Third Party 13
Download for v 19.0 Deploy on Odoo.sh Live Preview
Availability
Odoo Online
Odoo.sh
On Premise
Community Apps Dependencies
Lines of code 448
Technical Name sc_react_sidebar
LicenseOPL-1
Websitehttps://shachain.dev
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Community Apps Dependencies
Lines of code 448
Technical Name sc_react_sidebar
LicenseOPL-1
Websitehttps://shachain.dev
Shachain ✉ Email Us
Shachain ✉ Email Us

A Modern Collapsible Sidebar for Odoo

Replace the Odoo top navbar with a collapsible React + Mantine sidebar — recursive menus, fuzzy search, drag-to-resize, and a desktop-app feel.

▶ Live Preview
Shachain
React-powered addons for Odoo
Odoo with the React sidebar expanded showing nested menu tree

What it does

React Sidebar Navigation replaces the default Odoo top navigation bar with a modern collapsible sidebar. Built with React and Mantine, it renders menus recursively, respects user access rights, and integrates seamlessly with existing Odoo views.

React Sidebar Navigation Features

A collapsible, searchable side panel that gives Odoo a desktop-app feel — with zero menu configuration.

Collapsible Sidebar

Switch between expanded (260 px) and collapsed (56 px) modes with smooth transitions. Toggle with the chevron button or the [ / Cmd+\ shortcut.

Sidebar expanded at 260 pixels showing full menu tree
Sidebar collapsed to 56 pixel icon rail

Hover Flyout Submenus

In collapsed mode, hover any app icon to reveal its full nested menu tree as a floating panel — navigate deep submenus without re-expanding the entire sidebar. Powered by Mantine HoverCard with portal rendering.

Collapsed sidebar with hover flyout showing nested Contacts submenu

Recursive Nested Menus

Menus render recursively, supporting deeply nested menu structures with no configuration. Sub-menus inherit their parent app's context and expand on click in expanded mode, or appear in the hover flyout panel in collapsed mode.

Fuzzy Menu Search

Press Cmd+/ to focus the menu search. Type to fuzzy-filter the whole menu tree — matched substrings are highlighted, and the tree auto-expands to reveal every matching node along its path.

Sidebar fuzzy search with highlighted matches and auto-expanded path to By Project

Menu Customization

Users with the Edit Menu Icons privilege can right-click any menu item to open the Menu Settings dialog with three tabs:

  • Select Icon — pick from the built-in lucide-sourced SVG dictionary (140 icons)
  • Upload Icon — supply your own SVG / PNG (24×24 recommended)
  • Rename — change the menu's display name

Changes are written to ir.ui.menu (web_icon, web_icon_data, name) and become visible to every user in the company. The Edit Menu Icons privilege is granted to the System Administrator group by default and can be assigned to additional users from Settings > Users & Companies. ACL limits this group to read + write only on ir.ui.menu — adding or deleting menus is not permitted.

Menu Settings Select Icon tab with icon grid
Menu Settings Upload Icon tab
Menu Settings Rename tab

Drag-to-Resize

Drag the right edge to resize the sidebar between 180 and 400 px; the width persists in localStorage.

Respects Access Rights

Menu visibility follows each user's standard Odoo access rights — users only see what they are allowed to.

Built on

Powered by React and Mantine v8 — running natively on Odoo.

Frequently Asked Questions

Sometimes you need a quick answer to your question. You can get it right away here.

General

Does it modify Odoo's menu records?
Yes — but only when an authorized user opens the right-click Menu Settings dialog. That dialog calls ir.ui.menu.write() on the web_icon, web_icon_data, and name fields, so changes are global (visible to every user) and persist in the database. Only users with the Edit Menu Icons privilege can open the dialog — the System Administrator group has it by default. Plain navigation (reading and clicking menus) never writes anything.
Does it work on mobile?
The sidebar is desktop-first. On small screens it collapses to the icon rail; full navigation is best on desktop and tablet.
Can users still use the native navbar?
The sidebar replaces the top navbar once installed. Uninstall to restore the native navbar.
How do I customize menu icons?
Enable Debug mode, then right-click any menu item to open the icon picker.

Setup & Install

Step 1 — Download the addon
Download the addon zip from this App Store listing to your local machine.
Step 2 — Extract into your addons path
Unzip the package and place the addon folder inside one of the directories listed in your Odoo addons_path (configured in odoo.conf).
Step 3 — Update Apps List
In Odoo, enable developer mode, open Apps, and click Update Apps List so Odoo picks up the newly placed addon.
Step 4 — Install
Search for the addon by name in Apps and click Install. This module depends on the odoo-react bridge — install it first if Odoo reports a missing dependency.
React Sidebar Navigation Releases

Every update brings new capabilities. Track the latest features and enhancements.

Initial Public Release
🎉
Release 19.0.3.1.0 (May 2026)
  • First public version of the React Sidebar Navigation addon.
  • Bundles a collapsible sidebar, recursive nested menus, fuzzy menu search, drag-to-resize, debug-mode icon customization, and keyboard shortcuts.
  • Replaces the Odoo top navbar while respecting each user's standard menu access rights.

Give Odoo a desktop-app feel

Collapsible · Recursive menus · Fuzzy search · Icon customization

▶Live Preview ✉Email Us 
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.