Need help with rocketchat-dark-mode?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

234 Stars 92 Forks MIT License 246 Commits 11 Opened issues


An easy user-togglable dark mode for Rocket.Chat

Services available


Need anything else?

Contributors list


An easy user-togglable dark mode for Rocket.Chat

This repo was migrated for ease of collaboration from my gist which was a fork of chall8909's gist, to which this project is greatly indebted.


dark-mode-toggle.js creates and adds a click handler for a dark mode toggle button. This toggle button lives in the toolbar at the top of the left-hand sidebar:

Toggle dark mode on with moon icon

And when dark mode is active:

Toggle dark mode off with sun icon

dark-mode.css contains the styles which - y'know, make everything dark, like so:

Dark mode in action


NOTE: This repo aims to keep the dark mode working for the latest stable release of Rocket.Chat. Older versions may or may not work.

  • For Rocket.Chat versions 3.2.2 - 3.3.3, use the code from the 3.2.2 branch.
  • For Rocket.Chat versions 3.4.0 - 3.7.2, use the code from the 3.7.2 branch.
  • For Rocket.Chat versions 3.8.0 - 3.9.1, use the code from the 3.9.1 branch.
  • For Rocket.Chat versions 3.9.2 - 3.11.2, use the code from the 3.11.2 branch.
  • For current latest stable release, use the code from the master branch.

If you want to "install" this dark mode, here's all you need to do:

  1. Be an administrator of your Rocket.Chat instance, or send these instructions to one and pester them to do it for you
  2. Go to the Administration panel > Layout
  3. Copy the contents of dark-mode.css into Custom CSS
  4. Copy the contents of dark-mode-toggle.js into Custom Scripts > Custom Script for Logged In Users
  5. Refresh your local Rocket.Chat instance (a server restart is not required). You may need to clear your cache if using a web browser.


If you encounter any problems with this dark mode plugin, please open an issue - or better yet, fix it and open a pull request.

See the contributing guidelines.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.