Make your workspace yours. Colours, sounds, a themed sign-in screen and a clear view of who can do what, all inside your ERPNext / Frappe Desk. Pick one of 17 ready-made themes or build your own, choose the sounds the Desk plays, give the login page your own look, and let administrators see and change permissions in plain language.
One branch per framework version. You are looking at
version-16, the build for
Frappe / ERPNext 16. Running Frappe / ERPNext 15? Use
version-15.
The sidebar was the plainest part of the Desk. Not any more:
- Sidebar skins. A theme can paint the sidebar Tinted, Solid or Gradient, with an optional wave pattern. Most bundled themes come with one; tune yours in Theme Studio under Sidebar. Every combination is checked for readable text before it is saved. See section 4.11.
- Module icon colours. Accounting blue, Selling green, Buying orange, HR teal and so on: the sidebar's icons in their module's colour, so you can tell where you are at a glance. Part of the skin, one tick box.
- Mini rail. Ctrl+Shift+B (or Frappe's own chevron) folds the sidebar down to its icons. Hover it to peek at the labels without the page moving. Remembered per person, on every device. See section 3.2.
- Home page. An optional landing page with a greeting, shortcuts and a tile for every workspace you can open, with a count of your open to-dos. Off until an administrator switches it on. See section 7.2.
Upgrading from 2.0: pull the branch, then bench --site yoursite.com migrate, bench build --app nexus_theme and bench restart. Everyone sees a short "What's new" card once.
Two things people asked for most, and a card on the Desk that tells every user about them once:
- Command Palette. Press Ctrl+K (⌘K on a Mac) anywhere on the Desk and type. Open any record type, report, page or workspace, jump back to something you had open, search documents, switch your theme or density, mute sounds, open the studios — all without the mouse. See section 3.1.
- Density modes. Compact, Comfortable or Spacious: how much vertical room rows, fields and buttons get. Yours alone, set in Theme Studio or from the palette; administrators choose the site's starting point in Theme Settings. See section 4.10.
- A "What's new" card, shown once per person after an upgrade to a release that has something to say, with a button that takes them to each new feature. It never comes back for patch releases.
Upgrading from 1.x: bench update (or pull the branch), then bench --site yoursite.com migrate and bench restart. Nothing changes for anyone until they try the new things; Comfortable is exactly the spacing you have today. Full details in the Release Notes.
Every screenshot below is the app running on a real ERPNext 16 site.
| Theme Studio | Permission Inspector |
|---|---|
 |
 |
| Pick a theme and watch a miniature Desk repaint as you go. | See what a role or a person may do, record type by record type. |
| Command Palette (new in 2.0) | Density (new in 2.0) |
|---|---|
 |
 |
| Ctrl+K, type a few letters, Enter. Every record type, report, page, theme and action. | Compact, Comfortable or Spacious: how much room rows, fields and buttons get. |
| Sidebar skin + mini rail (new in 2.1) | Home page (new in 2.1) |
|---|---|
 |
 |
| The theme paints the sidebar; Ctrl+Shift+B folds it to icons. | Greeting, shortcuts and a tile for every workspace you can open. |
| Sign-in screen | Sound Studio |
|---|---|
 |
 |
| Optional two-column login page, painted in your theme. | Choose the sound the Desk plays for each event. |
And it is not only the app's own screens. A theme repaints the whole Desk — here is ERPNext's own Selling workspace, charts, number cards and sidebar included, with nothing configured beyond picking a theme:
The Selling workspace in Cyberpunk Neon: a deep violet sidebar, a magenta active item and buttons, cyan links.
- What Nexus Theme Gives You
- Install It
- Where to Find Everything on the Desk
- Theme Studio: Pick and Build Themes
- Sound Studio: Choose Your Sounds
- Permission Inspector: Who Can Do What
- Administrator Guide: Theme Settings
- The Record Types Behind It All
- Who Can Use What (Roles)
- Everyday Recipes
- How It Works Under the Hood
- For Developers
- Things to Know
- Troubleshooting and FAQ
- Requirements and License
Nexus Theme is one Frappe app with three tools inside it. Install it once and every feature is ready; nothing needs to be switched on.
| Tool | Who it is for | What it does |
|---|---|---|
| Theme Studio | Everyone who uses the Desk | Pick a theme, adjust colours and fonts with a live preview, generate a whole theme from one brand colour, pair a light and a dark theme, share themes with the team, export and import themes as files. |
| Sound Studio | Everyone who uses the Desk | Choose the sound the Desk plays on login, save, submit, cancel, delete, errors, email, alerts and notifications. Use a bundled preset or upload your own, set the volume, or mute everything. |
| Command Palette | Everyone who uses the Desk | Ctrl+K / ⌘K. Type a few letters to go anywhere on the Desk, search documents, switch your theme or density, or open the studios. |
| Density modes | Everyone who uses the Desk | Compact, Comfortable or Spacious spacing for rows, fields and buttons, chosen per person in Theme Studio. |
| Sidebar skins | Everyone who uses the Desk | Tinted, Solid or Gradient sidebars with an optional pattern and module icon colours, part of each theme. |
| Mini rail | Everyone who uses the Desk | Ctrl+Shift+B folds the sidebar to its icons; hover to peek. Remembered per person. |
| Home page | System Managers switch it on; everyone sees it | A landing page with a greeting, shortcuts and a tile for every workspace you can open. Off by default. |
| Permission Inspector | System Managers | Pick a person or a role and see, record type by record type, what they may View, Edit, Create, Delete, Submit and Cancel, which role gives them that, and change it safely from the same screen. |
| Theme Settings | System Managers | Site-wide controls: a default theme for everyone, an allowed list, whether people may build or share themes, the company logo and favicon, and a master switch for sounds. |
| Login Page | System Managers switch it on; everyone sees it | A two-column sign-in screen painted in the site's theme colours, with your logo, your headline and bullet points on a coloured panel. Off by default; Frappe's own login page stays until you turn it on. |
| Three record types | Nobody has to open them | Theme Definition, User Theme Preference and User Sound Preference are where the studios store everything. They are listed in the workspace so you can look, fix or pre-build a company theme — see section 8. |
Everything is per user. Your theme and sounds are yours; nobody else sees them unless you share a theme on purpose.
On Frappe Cloud: open your site, choose Apps → Install App, and pick Nexus Theme from the Marketplace. Nothing else to do.
Run bench version first and read the frappe line.
| Your bench | Branch to install | Install with |
|---|---|---|
| Frappe / ERPNext 16 | version-16 |
bench get-app --branch version-16 https://github.com/abbas0444/nexus_theme.git |
| Frappe / ERPNext 15 | version-15 |
bench get-app --branch version-15 https://github.com/abbas0444/nexus_theme.git |
There are only these two branches, and version-16 is the default, so leaving
--branch out also gets you the 16 build. Both hold the same features; they differ
only where the two frameworks differ. Installing the wrong one damages nothing, but
the app will not work properly — switch branches and run
bench --site yoursite.com migrate again.
On your own bench: run these commands. Replace yoursite.com with your site name.
cd /path/to/your/bench
bench get-app --branch version-16 https://github.com/abbas0444/nexus_theme.git
bench --site yoursite.com install-app nexus_theme
bench --site yoursite.com migrate
bench restart # or restart `bench start` in developmentInstallation does all of this for you:
- Creates the Theme User role and gives it to every Desk user, so Theme Studio and Sound Studio work at once. New Desk users get the role automatically when they are created or promoted.
- Loads the 17 bundled themes.
- Creates the Theme Settings record with every option switched off, so the app changes nothing about your site until you decide.
- Adds Theme Studio and Sound Settings to the avatar menu, the Nexus Theme tile to the apps screen, and the Nexus Theme workspace with all its shortcuts.
- Registers the Permission Inspector page for System Managers.
Updating later is the usual bench update or git pull followed by bench --site yoursite.com migrate. Your custom themes and sound choices survive updates.
Uninstalling (bench --site yoursite.com uninstall-app nexus_theme) removes the role, the menu items, the tile and the app's own tables. It never touches Frappe's own permission records.
| Place | What you will see |
|---|---|
| Avatar menu (top-right) | Theme Studio, Sound Settings |
Apps screen (the grid icon or /apps) |
A Nexus Theme tile that opens the workspace |
Nexus Theme workspace (/app/nexus-theme) |
Shortcuts to Theme Studio, Sound Studio, Themes, Theme Settings and Permission Inspector, plus cards for every record type the app owns |
| Command palette (Ctrl+K / ⌘K, or Ctrl+Shift+P) | Type theme, sound, permission or settings and press Enter — see 3.1 |
| Frappe's own Switch Theme dialog (avatar menu, Toggle Theme) | Every Nexus theme is listed there too, next to Frappe Light and Timeless Night |
| Direct links | /app/theme-studio, /app/sound-studio, /app/nexus-permission-inspector, /app/theme-settings |
Login page (/login) |
Frappe's own sign-in screen, or the Nexus login page once an administrator switches it on in Theme Settings |
The workspace at /app/nexus-theme: shortcuts on top, record types underneath. The three pages sit in the sidebar on the left.
The apps screen carries a Nexus Theme tile, and the avatar menu in the corner opens either studio from wherever you are:
Press Ctrl+K (⌘K on a Mac) on any Desk page, or Ctrl+Shift+P. A box opens with a search field and, before you type anything, the documents you had open most recently. Start typing and the list narrows as you go; the letters that matched are highlighted. ↑ ↓ move, Enter runs, Esc closes.
Open it and the actions are already there: the studios, every theme you may switch to (your current one marked), density, sounds.
Type sal inv: Sales Invoice, its reports, and New Sales Invoice, with the matched letters highlighted.
What it can reach, in the order the groups appear:
| Group | What is in it |
|---|---|
| Recent | The last documents you opened, from this session and from Frappe's own recent list |
| Actions | Open Theme Studio, Sound Studio, the Permission Inspector or Theme Settings (the last two for System Managers); Switch theme → every theme you may use, with your current one marked; Use Frappe's own theme; Density → Compact, Comfortable or Spacious; Mute or Unmute sounds; Reload; Log out; and anything another app registers |
| Go to | Every record type you may read (and New … for the ones you may create), every report, page and workspace |
| Search | Once you have typed two letters or more, matching documents from Frappe's global search — the same results, and the same permissions, as the search bar |
Matching is forgiving: od finds Order Delivery and Sales Order, pi finds Purchase Invoice, and the words you type may come in any order. Nothing is stored; each opening starts empty.
One thing to know. On Frappe 16 the Desk used Ctrl+K for its own search bar; the palette takes that shortcut over. Ctrl+G still opens Frappe's global search, and the search bar itself is where it always was. On Frappe 15 Ctrl+K was free.
It follows your theme: here on GitHub Dark, listing the themes to switch to.
Press Ctrl+Shift+B (⌘⇧B on a Mac), click Frappe's own chevron at the bottom of the sidebar, press Frappe's Ctrl+/, or pick Collapse sidebar in the command palette. The sidebar folds down to a narrow rail of icons and the page gets the room.
Hover the rail for a moment and it opens over the page, labels and all, without the page moving underneath. Move away and it folds back. Tabbing into it with the keyboard opens it too, and Esc closes it.
The command palette offers it too: type side.
Your choice is saved for you, not for the browser, so it follows you to every device. Press the same shortcut, or the chevron, to bring the full sidebar back; the chevron always stays visible on the rail.
On a phone-sized screen the rail stays out of the way: Frappe's own drawer takes over. On Frappe 15, which has no app-wide sidebar, the same shortcut and the same saved choice fold the side column of the page you are on.
- Click your avatar (top-right) and choose Theme Studio.
- Click any theme card. The Live Preview inside the dialog, a small mock-up of the Desk, shows how it looks.
- Happy? Click Apply and the whole Desk changes at once. Not sure? Click another card. Nothing is stored until you press Apply.
- Want to tweak it? Click Customize and adjust colours; the preview follows every change. Press View Login at any point to see the sign-in screen in the same theme.
- Want to keep your tweaks? Click Save as Custom…, give it a name and, if you like, tick Share with other users.
Your choice is remembered on every device you log in from.
Theme Studio. The Live Preview at the top is a miniature Desk — navbar, sidebar, table, buttons — so you can judge a theme before applying it. The buttons along the bottom are always in reach.
Click a different card and only the preview changes. The Desk behind it stays as it was until you press Apply:
View Login opens the sign-in screen in whichever theme is selected, without signing out:
| List | What is in it |
|---|---|
| Default Themes | The 17 themes that ship with the app |
| My Custom Themes | Themes you saved. Only you see them, and you can delete them here. |
| Shared by Others | Themes your colleagues chose to share with everyone |
A custom theme of your own (Brand Blue) sits under My Custom Themes; one a colleague shared shows under Shared by Others.
The 17 bundled themes are:
- Dark: Midnight Indigo, Graphite Dark, Nord Frost, Dracula, Tokyo Night, GitHub Dark, Material Ocean, Cyberpunk Neon
- Light: GitHub Light, Solarized Light, Ocean Breeze, Forest Green, Rose Quartz, Mint Fresh, Solar Warmth, Sepia Reader, High Contrast
Click Customize on any theme. The editor shows a Live Preview card and a set of controls. Every change is applied to the Desk behind the dialog as you make it.
Basic shows the controls most people need:
| Control | What it changes |
|---|---|
| Background | The main backdrop of the Desk |
| Text Color | Text on that backdrop |
| Accent | Links, highlights, the active item |
| Font Family | Inter, system fonts, monospace and more |
| Font Size | The base size everything scales from |
| Corner Radius | How rounded cards, buttons and inputs are |
| Hover Lift | Cards rise slightly when you hover over them |
The Basic tab. The green bar at the bottom is the readability check — it recalculates on every change, so you always know whether the theme is legible before you save it.
Advanced adds the rest of the 11 colours and the finer settings:
| Control | What it changes |
|---|---|
| Surface / Cards | Cards, sidebars and panels |
| Input Background | Search boxes and form fields |
| Muted Text | Secondary labels and hints |
| Accent Hover | The accent colour when you hover |
| Button Color, Button Text, Button Hover | The primary buttons |
| Border | Lines between sections |
| Font Weight | Lighter or bolder text overall |
| Animation Speed | How fast hover and fade effects run |
Open the Palettes tab and click a set. Every colour in the editor is filled together, and each set is checked for readability before it ships:
Indigo Mist · Forest Paper · Rose Quartz · Graphite Amber · Midnight Violet · Carbon Teal · Obsidian Rose · Nordic Frost
Use a palette as a starting point, adjust anything you like, then save.
Open the Generate tab, enter your brand colour, choose Light or Dark, and pick one of three readings of that colour:
| Variant | Best for |
|---|---|
| Neutral Canvas | A grey backdrop with your colour only on accents. Calm and focused. |
| Tinted Canvas | The backdrop carries a hint of your colour. Feels branded. |
| High Contrast | Stronger text and borders. Best for accessibility. |
Each card shows its contrast numbers and a Passes WCAG AA badge. The generator solves for readability rather than fixed lightness steps, so it works whether your brand is yellow, navy or anything in between. Click a variant to fill the editor, then fine-tune and save.
Every theme you save is tested first:
-
text on the background must reach a 4.5 : 1 contrast ratio
-
text on cards must reach 4.5 : 1
-
button text on buttons must reach 3.0 : 1
-
sidebar text on a Tinted, Solid or Gradient sidebar must reach 4.5 : 1, against the far end of a gradient and against the highlighted item too
If a check fails you get a clear message naming the pair of colours to fix. You cannot save a theme nobody can read.
The editor shows the result live, above the buttons: every pair, its ratio, and a green Passes WCAG AA when all of them do. When one fails, Auto-fix nudges the colour until it passes.
Click Auto Light/Dark in Theme Studio, choose a light theme and a dark theme, set the mode to Automatic and save. The Desk now follows your operating system: switch your computer to dark mode and the dark theme appears by itself.
While Automatic is on, applying a theme from the gallery replaces the half it belongs to: a dark theme becomes your dark theme, a light one your light theme, and the other half stays as it was. Colour overrides are kept per half too, so an accent you tuned on the light theme never paints over the dark one at night. If the theme you applied is not the one on screen right now, the studio says so.
Save as Custom… asks for a name and offers one tick box: share it, or keep it to yourself.
- Share: tick Share with other users when saving. The theme appears in everyone's Public Themes list. Untick it by saving again without the tick.
- Export: select a theme and click Export to download it as a
.jsonfile. - Import: click Import and choose a
.jsonfile from another site. The file is validated before anything is saved, so a bad or edited file cannot harm your site. - Delete: open My Custom Themes and click Delete on the card. You can delete a theme even while you or a colleague are using it; whoever was using it drops back to the site default, or to Frappe's own look if there is none.
Click Reset to Default at the bottom of Theme Studio, or choose Frappe Light, Timeless Night or Automatic in Frappe's own Switch Theme dialog. Both record that you want Frappe's built-in look, so an administrator's site default will not come back on your next reload. Pick any Nexus theme again to opt back in.
Just under the preview in Theme Studio is a Density switch with three positions. It changes how much vertical room the Desk gives everything — list rows, grid rows, form fields, buttons, inputs, sidebar items, dropdown entries — and nothing else: no colours, no font sizes, no widths.
| Mode | For whom |
|---|---|
| Compact | People who live in lists and grids and want more rows on the screen. About a fifth less height everywhere. |
| Comfortable | Frappe's own spacing, exactly as it is today. The default. |
| Spacious | More air in forms, easier to read on a large screen or with a touch screen. About a fifth more. |
Click one and the whole Desk changes at once and stays that way on every device you sign in from. It is independent of the theme: you can be on Frappe's own look and still be Compact. From the command palette, type density and pick a mode.
The Item list at Compact (left) and Spacious (right): the same twelve rows, a fifth less height or a fifth more.
An Item form at Compact and at Spacious. Widths never change, only the vertical room.
Density is per person. An administrator sets the site's starting point with Default Density in Theme Settings; anyone who has not chosen for themselves follows it, and changing it later changes their Desk too. Someone who picked a density keeps it whatever the site default does.
Every theme now decides how the sidebar looks. Open Theme Studio, pick a theme, and look under Customize → Sidebar:
| Setting | What it does |
|---|---|
| Sidebar Style | Plain is Frappe's own sidebar, exactly as before. Tinted washes it with a light shade of the accent. Solid paints it the accent colour. Gradient runs the accent into a deeper shade. |
| Wave Pattern | A faint wave at the foot of a Solid or Gradient sidebar |
| Module Icon Colours | Each sidebar icon in its module's colour: Accounting blue, Selling green, Buying orange, Stock indigo, HR teal, Manufacturing purple, Projects cyan, and so on. Anything else gets a steady colour of its own. |
| Sidebar Background, Sidebar Text, Sidebar Active Item (Advanced) | Pick the colours yourself. Leave them on Auto and they are worked out from the accent, with the text set to whichever of dark or light reads best. |
The live preview repaints its sidebar as you go, and the contrast check covers the sidebar too: its text against the background, the far end of a gradient, and the highlighted item. A bundled theme that fails is refused; your own theme saves with a warning so you can fix it.
Most bundled themes come with a skin: the dark ones Gradient or Solid, several light ones Tinted with icon colours on. GitHub Light and High Contrast stay Plain. Choosing Frappe's own look, or a Plain theme, leaves the sidebar exactly as Frappe draws it. On Frappe 15 the skin paints the top bar instead, since that is where 15 keeps its navigation.
- Click your avatar and choose Sound Settings (or open the Sound Studio shortcut in the workspace).
- Each row is one event. Press Preview to hear its current sound.
- Choose one of the three preset chips, or press Upload to use your own
.mp3or.wav. - Drag the volume slider for that event.
- Everything saves as you go. Close the dialog when you are done.
One row per event. Using default means the row is untouched; upload a file and it says so instead.
| Event | Plays when | Presets |
|---|---|---|
| Login | You arrive on the Desk | Welcome, Unlock, Bright |
| Logout | You sign out | Sign Off, Soft, Power Down |
| Save | You save a form | Pop, Ding, Chirp |
| Submit | You submit a document | Success, Confirm, Bell |
| Cancel | You cancel a document | Soft, Tick, Down |
| Delete | You delete something | Drop, Thud, Swipe |
| Error | Something goes wrong | Buzz, Alert, Low |
| An email is sent | Ding, Whoosh, Pop | |
| Alert | A notification banner appears | Chirp, Pulse, Ring |
| Notification | A real-time message arrives (the bell) | Bell, Ping, Pop |
| Missing Fields | You save with a required field empty | Warn, Nudge, Buzz |
On each row: Preview plays the current sound, Upload takes your own file, Default switches that event back to Frappe's own sound, and Clear removes your custom file. The three chips under Defaults: are the bundled presets; a Custom uploaded tag shows when your own file is in use.
At the bottom of the dialog:
- Enable sounds switch: mute every sound without losing your choices.
- Reset All to Default: asks for confirmation, then removes every custom sound so the defaults play again.
- Done closes the dialog. Every change was already saved as you made it.
Every sound is cut at three seconds, so a long file never becomes a nuisance. Uploaded files are ordinary Frappe files and are included in your normal backups.
All 36 bundled sounds are synthesised from scratch by tools/generate_sounds.py, so there are no licensing worries.
For System Managers. Open Nexus Theme → Permission Inspector or go to /app/nexus-permission-inspector.
Frappe has a small built-in form that is also called Permission Inspector (under Users → Permission Inspector, at
/app/permission-inspector). It checks one document for one person at a time. The Nexus Theme inspector is a different tool with its own address, so the two never get in each other's way.
- Roles decide what someone can do. Every person has roles such as Accounts User or Sales User, and each role allows actions like View, Edit or Create on each type of record. A person can do something if any of their roles allows it.
- User Permissions decide which records they can see. They narrow a person down to, say, one Company or one Customer. They never add abilities.
- Changing a permission changes a role. So a change made here applies to everyone who has that role, not only the person you picked.
The How does this work? button on the page shows the same three points.
Choose A person or A role and type a name. The page shows a summary in plain words, for example:
Abbas can view 120 types of records, edit 80, create 62 and delete 12.
Under it you see the person's roles, warnings that matter (the account is disabled, a role is switched off, the Administrator cannot be limited), six counters, and three buttons: Which records can they see?, Open this user, and Open Frappe's Role Permission Manager. A long role list folds after the first twelve; press N more to see the rest.
Step 1. Choose A person or A role, then type a name. How does this work? explains roles and permissions in three short paragraphs.
Looking at a person: their roles as chips, one plain-English sentence, and six counters. The counters follow every edit you make below, before anything is saved.
Each row is one record type (Frappe calls it a DocType), grouped under its module. Each cell is a tick box, so a whole column reads at a glance:
| Box | Meaning |
|---|---|
| Ticked (green) | Allowed |
| Empty | Not allowed |
| Amber, with a bar instead of a tick | Allowed only on records they created themselves |
| – (no box) | Does not apply to this record type (for example Submit on a record type that never uses submission) |
A small amber dot on the corner of a ticked box means the role also has a separate own records only rule on top. Hover any box for the same thing in words. The legend above the table repeats all of this.
By default the six main actions are shown: View, Edit, Create, Delete, Submit, Cancel. Switch the Main actions drop-down to All actions to add Amend, Print, Email, Reports, Import, Export, Share, Pick in lists, See masked values and any custom permission types on your site. Hover a column heading for a one-line explanation of that action.
The last column, Because of, names the role that gives the permission. Hover a cell to see every role behind it.
Filters above the table:
- Search a record type, e.g. Sales Invoice
- All modules narrows to one module
- Show everything / Only what they can access / Only what they cannot access / Only record types with customised rules / Only my unsaved changes
- Include child tables adds the rows inside other records (such as the items on an invoice); they follow their parent and cannot be changed on their own
Every box is the same size, so a column reads top to bottom at a glance. Rows are grouped by module; the record-type column stays put while the rest scrolls sideways.
A panel opens on the right with:
- What can Abbas do here? Every applicable action in words, worked out by Frappe's own permission engine from their roles, the way it decides for a record: Yes, No, Own only (only on records they created) or Shared records only (no role allows it, but some records were shared with them). A User Permission can still narrow which records a Yes applies to; Which records? shows it.
- Why? Each role's rule in words: Role Accounts User allows: View, Edit, Create, Submit…
- Which records? Any User Permission that narrows this record type, such as Only where Company is Acme Ltd.
- The standard rules before they were customised, if someone changed them.
- Buttons to open the same record type in Frappe's Role Permission Manager or to manage User Permissions.
Click any record type and the reasons open beside the table, without losing your place in it.
- Press Change permissions. An orange banner confirms you are in editing mode and reminds you that nothing is saved until you press Save.
- Looking at a role: click any box to tick or untick it. Looking at a person: click a box and a small dialog lists that person's roles. Tick the role that should allow the action, or untick the roles that currently allow it. The dialog reminds you that the change applies to everyone with that role.
- Related actions follow Frappe's own rules automatically, and the page tells you when they do: turning Edit off also turns off Submit, Cancel and Amend; turning Cancel on also turns on Submit and Edit; Import needs Create.
- Changed cells get an orange outline and a bar at the bottom counts your unsaved changes. Use Only my unsaved changes in the Show drop-down to review them.
- Press Save changes. A confirmation spells out every change in a sentence, for example Everyone with the role Accounts User will no longer be able to Edit on Sales Invoice. Confirm, and Frappe enforces it immediately. Discard throws the edits away.
Editing mode. The banner reminds you nothing is saved yet, changed boxes get an outline, and the counters above update as you go so you can see the effect before committing to it.
What you cannot change here, and why:
- The Administrator account is above the permission system.
- Roles Frappe manages itself (Administrator, and for managers who are not Administrator also All, Guest, Desk User and custom user-type roles).
- Child tables, and the DocType, Module Def and Patch Log record types that Frappe's own manager also refuses.
- A record type must keep at least one rule; the page refuses to remove the last one.
Press Which records can they see? in the summary to open the User Permissions panel. It lists every restriction on the person, such as Company = Acme Ltd, applies to every record type, with buttons to Add a restriction or Manage all in Frappe's own User Permission list. This layer is shown separately on purpose, so that abilities (roles) and visibility (User Permissions) are never confused.
- Every request is checked on the server: without the System Manager role, every read and write is refused, whether or not the page is visible.
- Writes go to the same Custom DocPerm records that Frappe's Role Permission Manager writes, so the two tools always agree.
- A batch of changes is saved as one transaction. If any rule is invalid, nothing is saved and the message names the role and record type at fault.
- After every save the permission cache is cleared and the rows are re-read from the database, so the table shows what Frappe now enforces rather than what was requested.
Open Nexus Theme → Theme Settings or /app/theme-settings. Every option is off by default.
| Setting | What it does |
|---|---|
| Site Default Theme | Applied to everyone who has not chosen a theme. Leave blank to keep Frappe's stock look. People who chose Frappe's own look on purpose are left alone. |
| Apply to Login & Website | Also applies the site default theme to the login page and the public website, not only the Desk. |
| Default Density | Compact, Comfortable or Spacious for everyone who has not chosen a density of their own in Theme Studio. Comfortable is Frappe's own spacing. |
| Use the Nexus Home Page + Home Layout, Show Greeting, Show Shortcuts | Opens the Desk on the Nexus home page (see 7.2). Off by default. |
| Allow Custom Themes | Lets people build and save their own themes in Theme Studio. |
| Allow Public Sharing | Lets people share a custom theme with everyone on the site. |
| Restrict Theme Choice + Allowed Themes | Shows only the listed themes in Theme Studio. Anyone already using another theme keeps it; they are not reset. |
| Allow User Sounds | Turn off to switch Sound Studio off for everyone: nobody's custom files or volumes apply, and the Desk plays Frappe's own sounds as if the app were not there. Their choices are kept for when it is switched on again. |
| Navbar Logo | Replaces the Frappe logo in the navbar. |
| Favicon | The browser-tab icon on the Desk and the website. |
| Login Background | A background image for the login page. On the Nexus login page it sits behind the coloured panel. |
| Use the Nexus Login Page | Replaces Frappe's sign-in screen with the app's own two-column page (see 7.1). Off by default. |
| Login Brand Name, Login Brand Logo | The name and logo above the sign-in form. Empty means the site's own app name and logo. |
| Sign-in Subtitle, Footer Line | The small line under Sign In, and a line at the bottom of the form. Leave the footer line empty and it reads ©, this year and the Login Brand Name. |
| Panel Headline, Panel Text, Panel Points, Panel Figure, Panel Figure Note | The words on the coloured panel: a large heading, a paragraph, up to six points shown with ticks, and an optional figure such as 300+ with a note. |
A theme can also be limited to certain roles: open the theme record (Themes list) and fill Restrict to Roles. People without one of those roles will not see it.
Tick Use the Nexus Login Page and /login becomes a two-column screen: your logo and the sign-in form on the left, a coloured panel with your headline, your points and an optional figure on the right. On phones the panel steps aside and the form fills the screen.
| On a computer | On a phone |
|---|---|
|
 |
Every word on that panel is yours to write. The screenshots show a site that filled the Panel Headline in with its own name; a fresh install shows a plain "Welcome back" until you type something else. The site default here is Midnight Indigo, so the panel wears its indigo sidebar colour.
It follows the theme. The page is painted from the Site Default Theme: background, text, inputs, the accent, the button and the corner radius all come from that theme, and the panel is painted in the colour the theme is known by: its sidebar colour when the theme has a Solid or Gradient sidebar, otherwise its accent, with a glow of the button colour in the corner. So a theme looks like one product from the sign-in screen to the Desk. Set a light theme and the page is light; set a dark one and it is dark. Someone who has already applied a theme of their own on the Desk sees the login page in their theme, because the browser remembers it; the page repaints before it is shown, so there is no flash of the wrong colours. With no site default theme set, the page uses a neutral light palette.
It keeps everything Frappe's login does. Password sign-in, the error banner, forgot password, sign-up, login with an email link, social logins, LDAP and two-factor all work exactly as before, because the page loads Frappe's own login script and keeps every element that script uses. Only the layout and the styling are the app's.
Remember me remembers your username on that device. It does not change how long you stay signed in; that is Frappe's session setting, and the checkbox will not pretend otherwise.
It cannot lock you out. Untick the switch and Frappe's own page is back at once. If anything about the page ever fails to render, Frappe's own page is served instead, automatically. No file in Frappe, ERPNext or any other app is changed by turning it on.
The name and logo above the form come from Login Brand Name and Login Brand Logo; left empty they fall back to Navbar Logo and the site's own app name and logo. The picture behind the panel comes from Login Background.
All of the wording lives in one place, in the Login Page section of Theme Settings:
Seeing it without signing out. Open Theme Studio, pick a theme, and press View Login. A preview of the sign-in screen opens, drawn with the theme you have selected and the words you have written, so you can judge it before anyone else sees it. It also works when the page is switched off, so you can look first and decide after. There is a picture of it in section 4.1.
Typical setups
- Company look for everyone, still free to personalise: set a Site Default Theme, tick Allow Custom Themes, leave Restrict Theme Choice off.
- Locked-down branding: set a Site Default Theme, tick Restrict Theme Choice and list the approved themes, untick Allow Public Sharing.
- No custom sounds on this site: untick Allow User Sounds. Frappe's own sounds still play; people who want silence untick Enable sounds in Sound Studio, or Mute Sounds in their Frappe settings.
Tick Use the Nexus Home Page in Theme Settings and the Desk opens on a home page instead of Frappe's own landing, for every Desk user.
- A greeting by time of day, with the date. Untick Show Greeting to leave it out.
- Shortcuts: Create New (the command palette, ready for the name of what to create), Reports and Notifications. Untick Show Shortcuts to leave them out.
- A tile for every workspace the person can open, taken from the same list Frappe's own sidebar uses, so nobody sees anything they could not already reach. A small badge counts their open to-dos in that module.
- Home Layout: Grid for tiles, or Compact list for a denser list.
It follows the theme, the density and right-to-left languages:
With Home Layout set to Compact list, the workspaces are a denser list instead of tiles:
Untick the box and the Desk goes straight back to Frappe's own landing on the next page load. Frappe's own desktop is always one click away through All apps on the home page. Anyone can also open the page on purpose at /app/nexus-home, or from the command palette with Open Home.
Everything the two studios do is stored in three ordinary Frappe record types, listed in the Nexus Theme workspace sidebar. You do not have to open any of them. Theme Studio and Sound Studio create and update these records for you. They are here so you can see what is stored, fix something by hand, or set a theme up for the whole company.
| Record type | Holds | Who owns a row | Do you create these by hand? |
|---|---|---|---|
| Theme Definition | One theme: its colours, fonts and corner radius | The app (the 17 defaults) or the person who saved it | Rarely — see below |
| User Theme Preference | Which theme one person is using | One row per person, named after them | No |
| User Sound Preference | Which sound one person hears for each event | One row per person, named after them | No |
One row is one theme. The 17 that ship with the app are here, and so is every theme anyone saved with Save as Custom….
Open one and you see exactly the values Theme Studio edits, in six groups: Identity, Colors, Buttons, Typography, Motion & Shape and Sidebar.
| Field | What it means |
|---|---|
| Theme Name | The name people see in Theme Studio |
| Theme Key | The short id used in the URL and in the stored preference. Lowercase letters, digits and hyphens. |
| Is Default | Ticked on the 17 themes that ship with the app. Those cannot be deleted. |
| Is Dark | Tells the app this is a dark theme, so Auto Light/Dark can pair it and the login page knows its polarity |
| Owner | The person who saved it. Empty on the shipped themes. |
| Public | Ticked means everyone on the site sees it under Public Themes |
| Restrict to Roles | Leave empty to show it to everyone. Fill it in and only those roles see the theme. |
| Colors / Buttons / Typography | The eleven colours, the font family, the base size and weight, and the corner radius |
| Sidebar | Sidebar Style (Plain, Tinted, Solid, Gradient), Sidebar Pattern, Module Icon Tints, and optional Sidebar Background, Text and Active Item colours. Empty colours are worked out from the accent. |
When to create a new one by hand
Most people never do — press Save as Custom… in Theme Studio instead, which fills every field for you and checks the colours for readability first.
Create one here when you want a company theme that already exists before anyone opens Theme Studio: for example, an administrator building "Acme Blue", ticking Public so everyone sees it, and then setting it as the Site Default Theme in Theme Settings. Doing it here also lets you restrict a theme to certain roles, which Theme Studio does not offer.
To create one: Theme Definition → + Add Theme Definition, then fill in
- Theme Name and Theme Key (both required — the key must be unique)
- Every colour under Colors and Buttons. Leaving one empty gives you a theme with a hole in it, so fill them all.
- Tick Is Dark if the background is dark, and Public if others should see it.
- Save.
Leave Is Default unticked. That flag marks the themes that ship with the app.
A faster route to the same place: build the theme in Theme Studio, press Save as Custom…, then open the row it created and tick Public or fill in Restrict to Roles.
One row per person, named after their account. It is what makes your theme follow you to every device you sign in from.
| Field | What it means |
|---|---|
| User | Whose preference this is. It is also the row's name, so there can only ever be one per person. |
| Use Frappe Theme | Ticked means this person turned Nexus off and is back on Frappe's stock look |
| Active Theme | The theme they are using |
| Mode | Single uses one theme all the time. Automatic follows the computer's light/dark setting. |
| Dark Theme | The theme used after dark when Mode is Automatic |
| Overrides | Any colours they changed by hand on top of the theme, stored as JSON |
| Density | Compact, Comfortable or Spacious. Empty means "follow the site's Default Density". A row may hold only a density and no theme. |
| Collapse Sidebar | Ticked while this person keeps the sidebar folded to a rail. A row may hold only this and no theme. |
When to create a new one: never, in normal use. The row appears by itself the first time someone presses Apply in Theme Studio, and updates every time they change something.
Two reasons an administrator might open one:
- To see what someone is using when they ask for help — quicker than asking them to read colours off their screen.
- To reset one person who has painted themselves into an unreadable corner: tick Use Frappe Theme and save, or just delete the row. Either way they are back on the site default the next time their Desk loads. Nothing else about their account is touched.
One row per person again, holding their master on/off switch and a child table of the sounds they chose.
| Field | What it means |
|---|---|
| Enabled | Their own master switch. Unticked means the Desk stays silent for them. |
| Sounds | One row per event they changed: the Event key (save, submit, login…), the Audio File and the Volume |
Only events the person actually changed appear in the table. An event with no row plays the sound that ships with the app.
When to create a new one: never, in normal use. Sound Studio writes this row the first time someone picks a sound or moves a slider.
An administrator might open one to silence one person (untick Enabled) or to remove a file someone uploaded by deleting its row. To take every custom sound off the whole site instead, untick Allow User Sounds in Theme Settings — that sets every row here aside, and Frappe's own sounds play.
Deleting a row is safe. These two preference records are only preferences. Delete one and that person simply goes back to the site default the next time their Desk loads; no theme, no sound file and no part of their account is lost.
| Feature | Needs |
|---|---|
| Theme Studio, Sound Studio, personal preferences | Theme User (granted automatically to every Desk user) |
| Theme Settings, Themes list edits, deleting other people's themes | System Manager |
| Permission Inspector | System Manager, checked on the server for every request |
| Website users (portal logins) | Nothing. They never see the Desk tools and never receive the Theme User role. |
I want to open Sales Invoice without touching the mouse. Ctrl+K, type sal inv, Enter. For a new one, type new sal inv.
I want more rows on my screen. Theme Studio → Density → Compact. Or Ctrl+K, type compact, Enter.
I want the whole width for a big report. Ctrl+Shift+B folds the sidebar to a rail. Press it again to bring it back.
I want a coloured sidebar. Theme Studio → pick a theme → Customize → Sidebar → Sidebar Style Gradient → Apply. Tick Module Icon Colours too if you like.
I want everyone to land on a home page. Theme Settings → Use the Nexus Home Page → Save.
I want dark mode at night and light in the day. Theme Studio → Auto Light/Dark → pick one of each → Mode: Automatic → Save.
I want the whole team on our brand colour. Theme Studio → Customize → Generate → enter the brand colour → choose a variant → Save as Custom with Share with other users ticked. Then, as an administrator, set it as the Site Default Theme.
I made a theme on staging and want it in production. Export on staging, Import on production, then set it as default or share it.
Everything went silent. Sound Settings → check the Enable sounds switch, then Mute Sounds in your Frappe user settings. Custom sounds stopped and Frappe's own play instead: ask an administrator whether Allow User Sounds is off in Theme Settings.
Why can Abbas delete invoices? Permission Inspector → A person → Abbas → search Sales Invoice → the Delete cell says Yes and the Because of column names the role. Click the row for the full reasons.
Stop the Sales User role from cancelling invoices. Permission Inspector → A role → Sales User → Change permissions → search Sales Invoice → click Cancel to make it No → Save changes → confirm.
Give a new role access to one record type. Permission Inspector → A role → the role → Change permissions → find the record type → click View to make it Yes (add Edit, Create and so on as needed) → Save changes.
Record types the app owns
| Record type | Purpose |
|---|---|
| Theme Definition | One theme: 11 colours, font, size, weight, corner radius, animation speed, hover lift, owner, public flag, role restrictions. The 17 bundled ones are marked Is Default and ship as fixtures. |
| User Theme Preference | One row per person: the active theme, the mode (Single or Automatic), the dark theme for Automatic, per-user colour overrides, and the Use Frappe's Built-in Theme opt-out. |
| User Sound Preference + User Sound Mapping | One row per person with the master switch and a child row per event (file and volume). |
| Theme Settings | The single site-wide settings record described above. |
| Allowed Theme, Theme Role | Child tables behind Allowed Themes and Restrict to Roles. |
How a theme reaches the screen. The active theme is placed in the page's boot data, so the first paint is already themed. theme_manager.js writes the theme's values into CSS variables on the page and marks the page light or dark; Frappe's own components pick the variables up. Frappe's built-in Switch Theme dialog is extended so Nexus themes appear there, and choosing one of Frappe's own themes hands control back cleanly.
How a sound plays. sound_manager.js wraps Frappe's sound player: it swaps in your chosen file per event, applies the volume, honours the master switch and cuts every sound at three seconds.
How the Permission Inspector reads and writes. It reads through Frappe's own helpers (get_valid_perms, get_all_perms, get_roles, has_permission) and writes through Custom DocPerm, the same mechanism the stock Role Permission Manager uses. It has no tables and no permission logic of its own; if it were removed, nothing about your permissions would change.
How the login page takes over /login. Frappe asks every registered page renderer whether it can serve a route, and an app's own renderers are asked first. The app registers one that answers yes only for /login, only while the switch in Theme Settings is on, and only if its template is present; otherwise it declines and Frappe's own login page renders. It reuses Frappe's login context (social logins, LDAP, sign-up, the already-signed-in redirect) and Frappe's login script, and adds the layout, the theme variables and a small head script that repaints the page in the visitor's remembered theme.
Safety checks on saved data. Colour and style values are validated before they are stored (no CSS can be injected through a theme), sound URLs must point at files this site serves, imported theme files are validated field by field, and the words an administrator types for the login panel are escaped before they reach the page.
nexus_theme/
├── api.py # whitelisted theme and sound API
├── hooks.py # includes, apps-screen tile, doc events, boot session
├── install.py / uninstall.py # Theme User role, menu items, desktop icon, assets
├── website.py # login page and website theming
├── login_page.py # the Nexus login page (page_renderer hook, opt-in)
├── templates/nexus_login/ # its template
├── permission_inspector/api.py # Permission Inspector API (System Manager only)
├── nexus_theme/doctype/… # Theme Definition, preferences, Theme Settings
├── nexus_theme/page/ # theme_studio, sound_studio, permission_inspector
├── nexus_theme/workspace/ # the Nexus Theme workspace
├── public/js, public/css # theme_manager, theme_switcher, theme_editor,
│ # sound_manager, sound_studio, brand_kit, …
├── public/sounds # 36 synthesised presets
├── utils/ # contrast, css_safety, palettes, palette_generator, web_css
├── fixtures/theme_definition.json
├── tests/ # pure unit tests (no site needed)
└── tests_site/ # site-backed tests
tools/generate_sounds.py # regenerates every preset sound
tools/generate_logo.py # regenerates the logo set in logos/
All methods live in nexus_theme.api and are whitelisted, so they work from frappe.call, REST (/api/method/nexus_theme.api.<name>) and server scripts. They act for the logged-in user and need the Theme User role.
# Themes
get_available_themes() # defaults, owned, public
get_active_theme() # theme, mode, dark theme, overrides, dark_overrides, density, sidebar_collapsed, source
set_active_theme(theme_name, overrides=None) # apply a theme (+ overrides); returns the half it went to
set_theme_mode("Automatic", dark_theme="dracula")
clear_active_theme() # back to Frappe's own look
save_custom_theme(payload, share_public=0) # payload = the 11 colours + style fields
delete_custom_theme(theme_name)
export_theme(theme_name) # portable JSON
import_theme(payload, share_public=0)
get_recommended_palettes() # the 8 curated palettes
get_login_preview() # brand + words for the login preview
generate_palette(seed="#8c6f3f", is_dark=0) # 3 accessible variants from one colour
# Mini rail
get_sidebar_collapsed() # {collapsed: 0|1}
set_sidebar_collapsed(1) # fold the sidebar to a rail for this person
# Home page
get_home_data() # greeting name, tiles (with to-do counts), settings
# Density
get_density() # {density: "compact", source: "user"|"site_default"|"default"}
set_density("compact") # key or label; empty means "follow the site default"
# What's new
nexus_theme.whats_new.get_notes() # the notes for the running release series
nexus_theme.whats_new.mark_seen() # remember that this person has seen them
# Sounds
get_user_sounds() # enabled + allowed flags, event -> {url, volume}
set_user_sound("save", file_url="/files/pop.wav", volume=0.6)
set_user_sound("save", volume=0.3) # volume alone; the file, if any, is kept
clear_user_sound("save")
toggle_user_sounds(enabled=0)
clear_all_user_sounds()Permission Inspector methods live in nexus_theme.permission_inspector.api and require System Manager:
get_options()
get_matrix(target_type="user", target="abbas@example.com", include_child=0)
get_matrix(target_type="role", target="Accounts User")
get_doctype_detail("user", "abbas@example.com", "Sales Invoice") # rules, live check, user permissions
get_user_permissions("abbas@example.com")
save_changes([{"doctype": "Sales Invoice", "role": "Accounts User", "ptype": "write", "value": 0}])
refresh_cache(target_type="user", target="abbas@example.com")save_changes validates every rule, cascades dependencies the way Frappe requires, saves the batch under a savepoint, clears the permission cache and returns the fresh matrix rows for the affected record types.
window.openThemeSwitcher(); // open Theme Studio
window.openSoundStudio(); // open Sound Studio
ThemeManager.applyTheme("theme_key", { bg_primary: "#ffffff" }); // apply now
ThemeManager.handOffToFrappe(); // back to Frappe's look
SoundManager.applyMapping({ save: { url: "/files/pop.wav", volume: 0.7 } });
SoundManager.setEnabled(false);
NexusDensity.modes(); // [{ key, label, description }, …]
NexusDensity.get(); // "comfortable"
NexusDensity.set("compact"); // applies and saves; returns a Promise
window.openCommandPalette(); // open the palette
NexusCommandPalette.register({ // add a command of your own; returns an unregister function
label: "Close the month",
hint: "Accounts",
keywords: ["period", "closing"],
run: () => frappe.set_route("period-closing-voucher", "new"),
});
window.openNexusWhatsNew(); // show the "What's new" card again
NexusRail.isCollapsed(); // true while the sidebar is a rail
NexusRail.set(true); // fold it (saved per person); returns a Promise
NexusRail.toggle();
window.openNexusHome(); // go to the Nexus home pageThe palette fires register commands under Actions. Density changes raise a nexus-density-change event on document with { detail: { density } }, and the rail raises nexus-rail-change with { detail: { collapsed } }. A theme's sidebar skin is exposed as html[data-sidebar-style] (tinted, solid, gradient; absent for Plain) and the CSS variables --theme-sidebar-bg, --theme-sidebar-bg-end, --theme-sidebar-text and --theme-sidebar-active-bg.
# Pure unit tests, no site needed
python -m unittest discover -s apps/nexus_theme/nexus_theme/tests
# Site-backed tests (set allow_tests on the site first)
bench --site yoursite.com set-config allow_tests true
bench --site yoursite.com run-tests --app nexus_theme
bench --site yoursite.com run-tests --app nexus_theme --module nexus_theme.tests_site.test_permission_inspector
bench --site yoursite.com set-config allow_tests falsepython3 tools/generate_sounds.py # rewrites public/sounds from the recipes in the script
python3 tools/generate_logo.py # rewrites logos/ (needs Pillow and fontTools)
bench build --app nexus_theme # rebuild the JS/CSS bundles after editing public/- Themes style the Desk, not hard-coded colours. A third-party app that paints its own fixed colours is not restyled. The built-in Frappe and ERPNext interface is.
- Restricting themes never resets anyone. If an administrator narrows the allowed list, people keep the theme they already have; they just cannot pick others outside the list.
- The login sound may be skipped. Browsers block audio until you interact with a page. Every other sound plays after your first click.
- Custom themes survive updates. New bundled themes never overwrite your own.
- Choosing Frappe's own look opts you out of the site default until you pick a Nexus theme again.
- Deleting a theme in use is allowed for your own themes; users of it fall back to the site default. A theme that is the site default or on the allowed list must be taken out of Theme Settings first.
- Permission changes are site-wide. The Permission Inspector edits roles, and a role is shared by everyone who holds it. The confirmation dialog states this before every save.
- The Nexus login page is a switch, not a default. Installing the app changes nothing about
/login. An administrator turns the page on in Theme Settings, and can turn it off again the same way; if it ever cannot render, Frappe's own page is served. - Ctrl+Shift+B folds the sidebar. Ctrl+B was already taken (bold text, and "new document" in list views). Some browsers use Ctrl+Shift+B for their bookmarks bar; on the Desk the sidebar takes it, and Frappe's own Ctrl+/ does the same job.
- A Plain theme leaves the sidebar alone. Sidebar skins only apply to themes that choose one, and never while you use Frappe's own look.
- Ctrl+K belongs to the command palette now. On Frappe 16 it used to focus the search bar; Ctrl+G still opens global search and the bar is still there to click.
- Comfortable density is exactly the old spacing. Installing 2.0 changes nothing on screen until someone picks Compact or Spacious, or an administrator sets a different Default Density.
- "Set User Permissions" is not a flag in Frappe v16. It was removed in an earlier version. The inspector shows the flags v16 actually has, including Mask and custom permission types.
I do not see Theme Studio in the avatar menu.
You may be a Website User rather than a Desk user, or the app was installed before your account and the role has not been granted yet. Ask an administrator to run bench --site yoursite.com migrate; it grants the Theme User role to every Desk user.
I picked a theme but nothing changed, or it went back after reload. Press Apply in Theme Studio; clicking a card only shows it in the Live Preview. If you chose a Nexus theme inside Frappe's own Switch Theme dialog, it is applied at once.
I saved a theme and cannot find it. Private themes are under My Custom Themes; shared ones under Public Themes.
A colleague cannot see the theme I shared. An administrator may have turned off Allow Public Sharing, or the theme has Restrict to Roles set and your colleague lacks those roles.
Sounds do not play. Check the Enable sounds switch in Sound Settings, then the browser's site permissions, then ask an administrator whether Allow User Sounds is off in Theme Settings. Refresh once and click anywhere on the page; browsers block audio before the first interaction.
The Permission Inspector page is missing or shows "not permitted".
Only System Managers can open it. Ask one to open /app/nexus-permission-inspector.
I changed a permission and the person still cannot do it. Open the record type in the inspector and read What can they do here?; it comes from Frappe's own permission engine. If it says Yes, ask the person to reload the page. If it says No, another rule or a User Permission is limiting them; the Why? and Which records? sections show which.
I want to undo a permission change. Change it back in the inspector, or open the record type in Frappe's Role Permission Manager and press Restore Original Permissions to return to the standard rules.
Can I use my company logo? Yes. Theme Settings → Navbar Logo, Favicon and Login Background.
How do I see the login page without signing out? Theme Studio → View Login.
I switched the Nexus login page on but still see Frappe's.
Reload once; if your bench runs under a process manager, restart it (bench restart) so the web server picks up the change. The page also falls back to Frappe's own when the site has not been migrated since the update.
The login page is in the wrong colours. It uses the Site Default Theme. If your own browser shows different colours from a colleague's, that is your remembered Desk theme; pick a theme in Theme Studio, or choose Frappe's own look, and the login page follows.
Can an administrator force one theme for everyone? Set a Site Default Theme and tick Restrict Theme Choice with that single theme in the allowed list. People who chose Frappe's own look keep it; everyone else sees the default.
Do I have to create Theme Definition, User Theme Preference or User Sound Preference records? No. The studios create and update all three for you. See section 8 for what each one holds and the few cases where an administrator would open one by hand.
Someone made their Desk unreadable and cannot get to Theme Studio. Open User Theme Preference, find the row named after them, tick Use Frappe Theme and save — or just delete the row. They are back on the site default the next time their Desk loads, and nothing else about their account changes.
I created a Theme Definition by hand and it looks broken. Every colour under Colors and Buttons has to be filled in; an empty one leaves a hole in the theme. Open it in Theme Studio instead and press Save as Custom…, which fills all of them and checks readability first.
Does any of this change my data? Themes and sounds change only colours and audio. The Permission Inspector changes permission rules only when you press Save and confirm, using the same records as Frappe's own manager.
- Frappe / ERPNext: version 16
- Python: as required by your Frappe 16 bench
- Database: MariaDB with InnoDB
- Browser: any modern browser with audio support
MIT licence for the code, every bundled theme and palette, the logo set and all synthesised sounds. See license.txt.
Nexus Theme · built with Frappe · by Abbas Raza