Taqnix Backend Theme documentation

What you get

If you host Odoo yourself

1. Unzip the package you downloaded. Inside is taqnix_backend_theme.zip. Unzip it: you get a folder named taqnix_backend_theme.
2. Copy that folder into one of your Odoo addons paths (the folders listed as addons_path in your odoo.conf), for example /opt/odoo/custom-addons/.
3. Restart Odoo so it sees the new module.
4. Log in as an administrator, switch on Developer mode (Settings → Activate the developer mode), open Apps, press Update Apps List and confirm.
5. Remove the “Apps” filter in the search box, search for Taqnix Backend Theme and press Install.
6. The page reloads and the backend now has the new look.

From the command line

# install (or update) the module in your database
./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_backend_theme --stop-after-init
./odoo-bin -c odoo.conf -d YOUR_DATABASE -u taqnix_backend_theme --stop-after-init   # after a new version

Docker, Odoo.sh and others

Put the taqnix_backend_theme folder in the directory you mount or deploy as custom addons, restart, update the apps list and install, as above. Odoo.sh: add the folder to your repository and push.

1. Open it any time with Alt+H or by clicking the grid icon at the top left. Esc closes it.
2. Type a few letters: apps and menu items are searched together, with the path shown under each result (for example Sales / Configuration).
3. Move with the arrow keys and press Enter. Ctrl-click (or Cmd-click) opens an app in a new tab.

Sidebar

Inside an app, a slim sidebar on the left switches apps with one click. The three-line button at the top expands it to show names; Odoo remembers your choice on that computer.

Top bar only

Prefer the classic layout? Choose Top bar only in the Theme Studio or in Settings → Theme and the sidebar disappears.

1. Click the sun or moon icon in the top bar.
2. Choose Light, Dark or Follow device under Appearance. It applies at once and is remembered for your user.
3. On a phone, open More in the bottom bar to find the same switch.

It is real dark mode, not a color filter. The theme supplies the dark palette that Odoo's own dark stylesheets expect, so modules that ship dark styles look right too.

Charts, pivots and filters

Company default

Administrators set what new users start with under Settings → Theme → Default appearance (Light, Dark or Follow device). Anyone who has picked their own keeps their choice.

1. Click the sun or moon icon in the top bar and choose Customize theme (administrators only).
2. Pick a palette, or set the colors yourself.
3. Look at the backend behind the panel: it already shows your choice.
4. Press Save theme to apply it for everyone in this company, or Discard to go back.

Palettes

17 ready-made palettes: Taqnix Violet, Odoo Aubergine, Deep Ocean, Forest, Nord, Midnight Teal, Graphite Lime, Royal Gold, Slate Ruby, Carbon Orange, Rose Mocha, Emerald City, Corporate Grey, Sandstone, Cherry Blossom, Dracula and High Contrast. A palette sets the two colors and the navigation style; you can fine-tune any of them afterwards.

Everything you can set

Shape and density

Launcher backgrounds

• Palette preset fills in the colors and navigation style for you.
• Only administrators see this page and the Customize theme entry.
• Press Save at the top, as on any Odoo settings page.

Colors, navigation style, fonts, background and the default appearance are stored per company. Each company can have its own brand. The theme shown depends on the company that is active in the top-right company switcher. Changes apply without rebuilding assets and without a flash of the old colors.

• The bar steps aside while you type and in screens that bring their own bar, like Discuss.
• Notched phones get safe-area spacing, and the browser toolbar takes the top bar's color.
• Forms and HTML fields never scroll sideways.
• You can turn the bottom bar off in the Studio or in Settings → Theme.

Switch a user's language to Arabic, Hebrew or Persian and the whole interface mirrors: the sidebar moves to the right, menus, kanban columns and forms flip. The choice of fonts includes Cairo, Tajawal and IBM Plex Sans Arabic.

What the module adds

CSS variables

At run time the theme sets design tokens on :root that you can use or override in your own module:

:root {
  --tx-primary: #6B3FE0;        /* brand color                      */
  --tx-primary-hover: ...;       /* hover / active shades            */
  --tx-secondary: #14B8A6;      /* sidebar highlight, badges        */
  --tx-on-primary: #fff;        /* readable text on the brand color */
}

/* in your own module's scss */
.my-card { border-color: var(--tx-primary-subtle-border); }

Read the colors from another app

A public endpoint returns the brand colors of the current company, handy for a companion mobile app (only public branding data is returned):

curl https://your-odoo.example.com/api/taqnix/theme_colors

Change a company's theme from code

company = env.company
company.write({
    'tx_primary_color': '#0B6BCB',
    'tx_secondary_color': '#38BDF8',
    'tx_nav_style': 'midnight',
    'tx_default_scheme': 'dark',
})

Settings apply on the next page load; no asset rebuild is needed.

Updating

Replace the module folder with the new one, restart Odoo and run -u taqnix_backend_theme (or press Upgrade on the module in Apps). Then hard-refresh your browser. Your colors and users' appearance choices are kept.

Coming from version 1

Version 1 stored its colors as system parameters. On installation the module copies them (primary color, accent color and navigation color) to every company automatically.

Removing

Uninstall Taqnix Backend Theme from Apps. Odoo's standard look returns immediately. Dark mode switches off with it, because Odoo's Community edition only turns it on through this module.

Installation help and bug fixes are included for 6 months, with lifetime updates. Contact us through the marketplace item page where you bought the module, or write to support@taqnix.com with your Odoo version, what you did, and a screenshot of what you see.