Kanakku Dolibarr Theme

1. Overview

Kanakku replaces the whole Dolibarr back-office interface with a clean, modern SaaS design: a white side navigation, a slim top bar with global search, a premium dashboard, and a full light/dark mode. It is delivered as a Dolibarr module — not a simple CSS theme — because the design requires its own page structure (custom sidebar, top bar and dashboard) that a stylesheet alone cannot produce.

Every standard Dolibarr screen (lists, record cards, setup pages, third-party modules) inherits the Kanakku palette automatically, in both light and dark mode, because the module re-defines the core theme's CSS variables rather than restyling each page.

2. At a glance

3. Key features

·       Custom side navigation built from Dolibarr's own menu tree, so every installed module keeps its menus, links and permissions.

·       Slim top bar with global search across customers, invoices, orders and products.

·       Premium dashboard: KPI tiles, a 12-month sales comparison chart, a sales-statistics strip, a commercial pipeline donut, recent activity, today's agenda, and side-by-side recent invoices and estimates.

·       Full light and dark mode, remembered per browser, with a no-flash pre-paint script.

·       Collapsible sidebar rail on desktop and an off-canvas drawer on mobile.

·       Native Dolibarr widgets are kept: users can still add, hide and reorder the standard dashboard boxes, saved per user.

·       Configuration screen for colours, corner radius, font size, menu width, dark-mode default and dashboard options — no code editing required.

·       Permission-aware menu: sections a user is not allowed to open are hidden entirely rather than shown and then refused.

·       Responsive down to 390 px with no horizontal scrolling, verified in-browser.

4. The dashboard

The dashboard is the module's landing page. Users arrive on it directly after login, and every figure it shows is read live from the Dolibarr database.

KPI tiles are clickable: each one opens the matching Dolibarr list, filtered to exactly the same period and status as the figure on the tile, so the list total always matches the number shown.

5. Dark mode

Dark mode is a first-class mode, not an inversion filter. Each design token has a dedicated dark value, and because the module overrides Dolibarr's core CSS variables, standard pages follow the dark palette automatically.

6. Navigation

The sidebar is generated from Dolibarr's native menu tree, so third-party modules appear automatically with their own entries and icons. Groups expand in place without reloading the page, and the active entry is highlighted with a soft accent pill.

7. Standard Dolibarr screens

Lists, record cards and administration screens are restyled through the same design tokens: rounded cards, hairline borders, accent-coloured tabs and buttons.

8. Configuration

The module ships a dedicated configuration screen, grouped into Appearance, Side menu and Dashboard sections. All settings are stored as Dolibarr constants and applied on the next page load.

Available settings:

·       Primary, accent, success, danger and warning colours (colour pickers).

·       Corner radius and base font size.

·       Optional web font, or system fonts only for installations without internet access.

·       Dark mode as the default for new visitors.

·       Side menu width; show or hide the Favourites and Recently-opened sections; number of recent items to keep.

·       Turnover basis (excluding or including tax) and whether abandoned invoices count — the same setting feeds the KPI, the chart and the list links, so they always agree.

·       Optionally disable the custom dashboard or hide the native widget area.

9. Mobile

The interface is fully responsive. On phones the sidebar becomes an off-canvas drawer opened from the top bar, cards stack to a single column, and tables fit the screen without horizontal scrolling.

10. Installation

1. Copy the kanakku folder into your Dolibarr custom directory (or upload module_Kanakku-1.0.zip through Home → Setup → Modules → Deploy module).

2. Go to Home → Setup → Modules, find Kanakku in the Interfaces family, and enable it.

3. The interface changes immediately. If the sidebar does not appear, disable and re-enable the module once — this re-applies the forced-menu settings.

4. Adjust colours and options in Home → Setup → Modules → Kanakku → Configure.

To uninstall, simply disable the module: Kanakku removes its own settings and Dolibarr returns to its standard interface. No data is modified at any point.

11. Technical notes

·       The theme never modifies Dolibarr core files. It installs entirely under custom/kanakku.

·       CSS and JavaScript are injected through the standard module_parts mechanism and carry a revision number, so users receive updated assets on a normal page reload.

·       Only documented Dolibarr APIs are used; each one was checked against both the 16.0 and the development branch to confirm the supported version range.

·       All interface text is translatable — the seven shipped language files hold identical keys, so adding a language is a matter of copying one file.

·       No external network call is required at runtime; the web font can be switched off.

Kanakku 1.0  ·  © 2026 DoliResources  ·  www.doliresources.com