FAQ and Troubleshooting

FAQ and Troubleshooting

Themes

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.

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.

Can I use my company logo? Yes. Theme Settings → Navbar Logo, Favicon and Login Background.

Sounds

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 login sound never plays. Browsers block audio until you interact with the page, and login happens before any click. Every other sound plays normally.

Permission Inspector

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 opened /app/permission-inspector and got a different screen. That address belongs to Frappe's own built-in form of the same name. The Nexus Theme page is at /app/nexus-permission-inspector, and the workspace shortcut always goes to the right one.

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 is checked live. 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.

Why does the page refuse to remove a rule? A record type must keep at least one rule. Set the actions to No instead of removing the last rule.

General

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.

Does uninstalling leave anything behind? No. Uninstalling removes the Theme User role, the menu items, the tile and the app's own tables. Permission rules stay exactly as they are, because they live in Frappe's own records.

Something is still wrong. Open an issue at https://github.com/abbas0444/nexus_theme/issues with your Frappe and ERPNext versions, what you did and what happened.