Skip to Content

Shell

by ,
Odoo
v 19.0 Third Party
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 7069
Technical Name praetorx_shell
LicenseLGPL-3
Websitehttps://praetorx.net
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 7069
Technical Name praetorx_shell
LicenseLGPL-3
Websitehttps://praetorx.net

PraetorX Shell

Make Odoo Look Like Yours — Branded Backend Theme for Odoo 19

v19.0.7.0.0 Community Enterprise Odoo.sh Light & Dark Mode Free

Replaces the standard Odoo interface with a fully branded, productivity-focused experience. Multi-tab navigation, extended Cmd+K search, per-role color theming, branded login page, activity dashboard, collapsible sidebar, and background task progress — all configurable without code.

praetorx.net | Syntax & Sabotage

Branding & Theming

Branded Login Page

Custom background image or color, company logo, welcome text, and accent color. “Powered by PraetorX” footer. All configurable in Settings — no CSS knowledge required.

Full Color Theming

6 configurable theme colors (brand, primary, success, info, warning, danger) with separate palettes for light and dark mode. One-click reset to defaults.

Per-Role Color Presets

Define a color palette per role — the interface adapts automatically based on the user’s role assignment. Preview before applying.

Branded Splash Screen

Animated PraetorX splash screen during initial page load. Pure CSS/HTML, no JS dependency. Auto-dismisses when the UI is ready. ARIA-labeled for accessibility.

Navigation

Multi-Tab Navigation

Browser-style tabs for multiple open records. DnD reorder, close/middle-click, context menu (close others, close right, duplicate). Keyboard shortcuts: Alt+W, Alt+←/→, Alt+1-9. Persisted via sessionStorage.

Extended Cmd+K Search

@ namespace for record search across configurable models. Recents provider shows last edited records from localStorage. Quick-create actions for contacts, quotes, invoices, tasks.

Smart Sidebar

Collapsible sidebar with flyout submenus, drag-and-drop reordering, hideable sections and apps. Ctrl+Click opens items in a new tab. Per-user preferences persisted automatically.

Domain Tiles & Home Screen

Admin-configurable tiles with icon, color, and menu target. Group-based visibility. Left/right logo slots, brand caption, time-based greeting, and “Recently Edited” tracking.

Productivity

Activity Dashboard & My Day

Urgency buckets: overdue, today, this week. “My Day” shows today’s calendar events with duration and relative time labels. Filterable by model, per-user hidden models.

Chatter Position

Per-user chatter placement: bottom (default) or side panel with draggable divider. No more scrolling past long chatters to reach form fields.

Background Progress

Long-running tasks report progress via bus notifications. Toast UI with label, percentage, and status message. Server pushes to browser in real time.

Loading Bar & Skeleton Loaders

Visual progress bar for RPC calls and page transitions. CSS skeleton utilities for placeholder content while data loads. Smoother perceived performance.

Technical Reference

ComponentTechnology
Tab NavigationOWL service + component — sessionStorage persistence, async replay with generation counter, loading indicator
Cmd+K SearchOWL command providers — record search via name_search, recents from localStorage, quick-create actions
SidebarOWL component — collapse, DnD reorder, flyout submenus, per-user JSON preferences
Color ServiceOWL service — resolves role-based presets via JSON-RPC, injects CSS variables at runtime
Progress Trackingbus.bus notifications — server pushes to browser, toast UI with percentage bar
Activity DashboardOWL client action — JSON-RPC data, urgency buckets, My Day calendar integration
Color ThemingSCSS variables + QWeb CSS injection — light/dark mode, 6 theme colors, runtime override
Login BrandingQWeb template inheritance — replaces web.login_layout, controller-served assets

Use Cases

Corporate Branding

Replace Odoo’s default look with your company colors, logos, and login experience — no CSS knowledge required.

Role-Based UX

Different color palettes per role — sales sees blue, operations sees green. Visual role separation at a glance.

Daily Productivity

Start each day with “My Day” — today’s calendar events and overdue activities in one view. Tabs keep multiple records open side by side.

Simplified Navigation

Domain tiles and a collapsible sidebar reduce clutter. Cmd+K with @ search finds any record instantly. Users see only what they need.

Screenshots

Branded Home Screen

Multi-tab navigation, recently edited items, calendar widget, and activity dashboard — all on the customized home screen.

PraetorX Shell — Branded Home Screen with Multi-Tab Bar
Configuration

All branding options in one place: logos, caption, login page, background image, accent color, record search models, and quick actions.

PraetorX Shell — Settings and Configuration
Record Search (Cmd+K)

Extended Cmd+K with @ namespace for searching records across configurable models.

PraetorX Shell — Cmd+K Record Search
Sidebar Configuration

Collapsible, customizable sidebar with per-item visibility controls. Drag to reorder, toggle sections on or off.

PraetorX Shell — Sidebar Configuration

Setup Guide

  • Odoo 19.0 (Community or Enterprise)
  • Python 3.10+
  • Required modules: bus, mail, web
  • PraetorX modules: praetorx_base

No Enterprise dependency. Works on Community, Enterprise, and Odoo.sh.

Install from the Odoo Apps menu. Search for “PraetorX Shell” or “Shell”.

Shell requires praetorx_base — this will be installed automatically as a dependency.

  1. Navigate to PraetorX → Configuration → Settings
  2. Login Page: Upload background image, set fallback color, add your logo and welcome text
  3. Home Screen: Upload left/right logos, set brand caption
  4. Colors: Adjust theme colors for light and dark mode (brand, primary, success, info, warning, danger)
  5. Click Save — changes apply immediately
  1. Navigate to PraetorX → Configuration → Shell Tiles
  2. Each tile has: name, Font Awesome icon, accent color, target menu XML ID
  3. Assign groups to control visibility — empty means visible to all
  4. Drag to reorder, toggle active/archived
  1. Navigate to PraetorX → Configuration → Color Presets
  2. Create a preset and assign it to a role
  3. Set colors for brand, primary, success, info, warning, danger
  4. Click Preview to see the colors applied temporarily

When a user logs in, the system resolves their role and applies the matching color preset automatically.

  1. Navigate to PraetorX → Configuration → Settings
  2. Under Search (Cmd+K), configure which models appear in @ record search
  3. Toggle quick-create actions on/off

FAQ

No. Works on Community, Enterprise, and Odoo.sh. Depends on bus, mail, web (all included in Odoo Community) and praetorx_base.
Shell extends the standard Odoo UI through template inheritance and SCSS variable overrides — it does not replace the Odoo web module. Third-party themes may conflict with color theming; test in a staging environment first.
Shell requires only praetorx_base as a PraetorX dependency. You do not need Vault, FlowForge, Invoice Pro, or any other PraetorX application module.
Shell’s dashboard groups activities into urgency buckets (overdue, today, this week) and adds “My Day” — a combined view of today’s calendar events and due activities with duration and relative time labels. Users can hide irrelevant models to reduce noise.
Yes. Each user can collapse/expand the sidebar, hide sections or apps, reorder tiles and groups via drag-and-drop. All preferences are stored per user and persist across sessions.
The default limit is 15 tabs, configurable via the praetorx_shell.max_tabs system parameter. Tab state is persisted in sessionStorage — tabs survive page reloads but not new browser sessions. The tab bar is hidden on mobile viewports (<768px).
Yes. Shell provides separate color palettes for light and dark mode. The login page, splash screen, sidebar, navbar, tabs, and all custom components adapt automatically when the user switches modes.

Release History

v19.0.7.0.0 — March 2026

Current Release

  • Extended Cmd+K search — @ record search, recents provider, quick-create actions
  • Browser-style multi-tab navigation with DnD reorder, keyboard shortcuts, context menu
  • Per-role color theming with color presets and preview
  • Branded login page: background image/color, logo, welcome text, accent color
  • Smart sidebar: collapsible, DnD reorder, flyout submenus, Ctrl+Click tab support
  • Domain tiles: admin-configurable, group-based visibility, custom icons/colors
  • Activity dashboard with urgency buckets and “My Day” widget
  • Full color theming: 6 colors × 2 modes (light/dark), one-click reset
  • Branded home screen with logos, caption, greeting, recently edited records
  • Branded splash screen (pure CSS/HTML, ARIA-labeled)
  • Chatter position toggle (bottom / side panel with draggable divider)
  • Loading bar for RPC calls and page transitions
  • Background task progress tracking via bus notifications
  • Role-gated debug mode toggle in sidebar
  • German translations (de.po, 160+ strings)

You May Also Like

Cockpit Works with Shell

Role-based tile dashboard — counters, queues, charts, actions, and real-time updates. The natural next step after Shell.

Free
PraetorX Roles

Role-based user group management with date-gated assignments. Enables per-role color presets in Shell.

39 EUR
Vault

AI document management — classification, routing, retention.

199 EUR
Invoice Pro

Validated & structured invoicing with ZUGFeRD, XRechnung, Peppol.

249 EUR

Made with ♥ by Syntax & Sabotage

© 2026 Syntax & Sabotage, Lars Weiler. All rights reserved. LGPL-3.

Impressum · support@syntaxandsabotage.io

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.