Skip to main content

Troubleshooting

Theme Not Showing After Installation

Symptom: After bench restart, the site still shows the default Frappe theme.

Steps:

  1. Confirm the build completed without errors:
    bench build --app solvronix_desk
  2. Hard-refresh the browser (Ctrl+Shift+R or Cmd+Shift+R) to clear cached CSS
  3. Confirm the app is installed on the correct site:
    bench --site your-site.com list-apps
    solvronix_desk should appear in the list

Colors Not Updating After Saving Theme Settings

Symptom: You saved new colors in Theme Settings but the interface still shows the old colors.

Steps:

  1. Hard-refresh the browser (Ctrl+Shift+R) — the browser may have cached the old CSS variables
  2. If still showing old colors, open DevTools → Application → Clear site data → reload
  3. Confirm you clicked Save in Theme Settings (not just navigated away)

Command Palette Not Opening

Symptom: Ctrl+K does nothing.

Steps:

  1. Confirm you are on the Frappe desk page (not a report or print page that may capture keyboard events differently)
  2. Check if another browser extension has claimed Ctrl+K — try in an Incognito window
  3. If it works in Incognito, disable extensions one by one to find the conflict

Logo Not Appearing

Symptom: You uploaded a logo in Theme Settings but it doesn't show in the navbar or login page.

Steps:

  1. Confirm you clicked Save after uploading
  2. Hard-refresh the browser
  3. Check that the uploaded file is PNG or SVG — JPG files without transparency may appear as a white box on the colored navbar
  4. Try uploading a smaller file (under 200 KB) if the upload appeared to hang

Dark Mode Not Persisting

Symptom: Dark mode resets to light mode after signing out and back in.

Steps:

  1. Confirm you are signed in — dark mode preference is saved per user, so it requires an authenticated session to persist
  2. The preference is stored in your Frappe user settings; if those settings were reset by an administrator, dark mode would revert

Getting Help

If none of the above resolves your issue: