Simple Dark Mode – Flarum 2

huseyinfiliz

A simple dark mode toggle extension for Flarum 2.

Simple Dark Mode adds a quick theme toggle to your forum, allowing users and guests to switch between light and dark mode without opening the full appearance settings.

Features

🌙 Quick theme toggle: Adds a simple light/dark mode button to the forum header.
👤 User preference support: Logged-in users keep their selected theme through Flarum preferences.
👥 Guest support: Guest users can also switch themes, with their choice stored locally in the browser.
♿ High contrast support: Preserves Flarum’s high contrast modes when switching between light and dark.
⚙️ Admin settings: Optionally control header visibility and icon style.

Installation

composer require huseyinfiliz/simple-dark-mode:"*"
php flarum cache:clear

Then enable the extension from your admin panel.

Updating

composer update huseyinfiliz/simple-dark-mode:"*"
php flarum cache:clear

To remove:

composer remove huseyinfiliz/simple-dark-mode
php flarum cache:clear

Notes

This extension is intentionally simple. It does not add a custom theme system; it uses Flarum’s existing color scheme support and only provides a faster way to switch between modes.

Links

If you liked this extension, don’t forget to check out my other extensions too: huseyinfiliz.com/flarum

MrLaviana1

huseyinfiliz I love it—simple, straightforward, and above all, functional; I've applied it to my website.

huseyinfiliz

MrLaviana1 Thank you, I’m really glad you like it!

Simple things are often the hardest to get right — and that was exactly the goal here: keep it small, clean, and predictable.

I’ve also never been a big fan of the extra “Auto” option in theme toggles. Since I first discovered Flarum, I wanted a button that simply detects the current effective theme and switches to the opposite one.

MrLaviana1

huseyinfiliz I totally agree! That simplicity is precisely what makes me like your extension; it’s intuitive for users. I really like that specific detail regarding theme switching when HQ is set as the default—how it toggles specifically between Light, Dark, and HQ modes!

Forogramero

Simply oustanding!

Stezkoy

Tell me, how is this extension different from ernestdefoe/theme-toggle?

huseyinfiliz

Stezkoy Too simple. No dropdown, just a toggle.

huseyinfiliz

Why You Should Keep Using Simple Dark Mode

With Flarum 2 RC-6, Flarum introduced a new built-in theme selector, as shown in the screenshot above.

While this is a nice addition to Flarum, I personally still recommend keeping Simple Dark Mode enabled if you prefer a simple and straightforward theme-switching experience.

The new theme selector displays an icon for the currently active theme on the button. Personally, I find this a little confusing, since the button doesn't immediately indicate that it is a theme selector. It also requires opening a dropdown menu to switch between themes, which I find unnecessary for such a simple action.

If you prefer the familiar Simple Dark Mode experience, you can continue using it without any problem.

How to keep using Simple Dark Mode

You only need to disable the Show theme selector option in Flarum's appearance settings, as shown in the screenshot above, and then save your settings.

That's all! Simple Dark Mode will continue to provide its simple and familiar theme switching experience.

Thank you for continuing to use Simple Dark Mode! ❤️

Gerriet

Hi there ;D
You my hero, the first question from a user in my "old" forum, has Flarum dark mode extension ? and I .. hmmm .. I would search ;D And here is it ;D

Thanks for you work ;D

Charity

Thanks a lot for your contribution to Flarum.