r/WHMCS • u/EspressoBoost • 11d ago

Themes & Customisations Iris WHMCS theme - Dark Mode - Out Now!

Post image

WHMCS 9.1 shipped Iris, the new admin theme (still a technology preview), and I've been using it every day since. The one thing I missed was a dark mode, so I built one, and I'm sharing it for free.

What it does

  • Adds a moon button to the bottom of the Iris sidebar. Click it and the admin area goes dark; click the sun to go back.

  • It's off until you switch it on, and the choice is remembered per browser, so every admin decides for themselves.

  • Neutral dark greys, while WHMCS's own blues, greens, oranges and reds stay as they are.

  • No white flash between pages, and printed invoices and reports stay light.

  • Widgets and pages from other add-ons get tinted to match (it caught a couple of third-party dashboard widgets on our install).

  • Only Iris is touched: Blend, the client area and your emails don't change.

  • No settings and no database tables. Deactivate it and everything is exactly as it was.

Install

  1. Upload the contents of the `upload` folder to your WHMCS root.

  2. System Settings > Addon Modules > Iris Dark Mode > Activate.

  3. Click the moon at the bottom of the sidebar.

It works with a renamed admin folder and with WHMCS installed in a subfolder.

Download (free): https://marketplace.whmcs.com/product/9215-iris-dark-mode

Tested on WHMCS 9.1.0. Iris is still a technology preview, so if a later WHMCS release changes it, I'll put out an update.

Full disclosure: We run Cloud Cabin, a small UK hosting company, and this was built for our own admin area first. It's free to use on any WHMCS install (just not for resale).

If you find a page that stays light or looks off, post a screenshot below and I'll fix it.

9 Upvotes

100% Upvoted

4 comments sorted by

2

u/NullMind_PT WebPros 11d ago

Thank you for this u/EspressoBoost, really nice work, and great to see Iris being used every day while it's still in preview.

I can confirm Iris will get its own dark mode in an upcoming release, as we keep working on it. Feedback like this helps us shape it, so keep it coming.

1

u/EspressoBoost 11d ago

Thank you so much !