PHPackages                             huseyinfiliz/simple-dark-mode - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. huseyinfiliz/simple-dark-mode

ActiveFlarum-extension[Utility & Helpers](/categories/utility)

huseyinfiliz/simple-dark-mode
=============================

A simple dark mode toggle for Flarum 2

1.0(1mo ago)0181↑55%MITTypeScript

Since Jul 8Pushed 1mo agoCompare

[ Source](https://github.com/huseyinfiliz/simple-dark-mode)[ Packagist](https://packagist.org/packages/huseyinfiliz/simple-dark-mode)[ Docs](https://huseyinfiliz.com/flarum/)[ RSS](/packages/huseyinfiliz-simple-dark-mode/feed)WikiDiscussions 2.x Synced 1w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

[![](https://camo.githubusercontent.com/fafea014feccba368232fb319f3dfc74a4f276f4702d0734b0982ae71f076e22/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30372d30382f313738333530313033382d32393237332d73696d706c652d6461726b2d6d6f64652e706e67)](https://camo.githubusercontent.com/fafea014feccba368232fb319f3dfc74a4f276f4702d0734b0982ae71f076e22/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30372d30382f313738333530313033382d32393237332d73696d706c652d6461726b2d6d6f64652e706e67)

Simple Dark Mode
================

[](#simple-dark-mode)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)[![Latest Stable Version](https://camo.githubusercontent.com/68f83d916f6dc68c4714dc701818ba71c23d9b4fab9b1ca6ac4d4b5d1647bc23/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6875736579696e66696c697a2f73696d706c652d6461726b2d6d6f64652e737667)](https://packagist.org/packages/huseyinfiliz/simple-dark-mode)[![Total Downloads](https://camo.githubusercontent.com/fb9e234d703ae83cac3512a47a242ebd8e133ff80dc8b941f825abb4586b420f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6875736579696e66696c697a2f73696d706c652d6461726b2d6d6f64652e737667)](https://packagist.org/packages/huseyinfiliz/simple-dark-mode)

A simple dark mode toggle extension for [Flarum](https://flarum.org) 2.

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

[![](https://camo.githubusercontent.com/ef0337a15aded5d01f01968175d607b9c6f8437119c9842db69618389545e511/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30372d30382f313738333530313034392d3737333132372d73696d706c652d6461726b2d6d6f64652e676966)](https://camo.githubusercontent.com/ef0337a15aded5d01f01968175d607b9c6f8437119c9842db69618389545e511/68747470733a2f2f63646e2e646973637573732e666c6172756d2e6f72672f323032362d30372d30382f313738333530313034392d3737333132372d73696d706c652d6461726b2d6d6f64652e676966)

Features
--------

[](#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**: Control header visibility and icon style.

Installation
------------

[](#installation)

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

Then enable the extension from your admin panel.

Updating
--------

[](#updating)

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

Removing
--------

[](#removing)

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

Notes
-----

[](#notes)

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

High contrast modes are preserved when toggling:

```
light     -> dark
dark      -> light
light-hc  -> dark-hc
dark-hc   -> light-hc

```

For guest users, the selected theme is stored in the browser. This means the preference may be cleared if the browser storage is cleared or when using private/incognito mode.

Links
-----

[](#links)

- [Discuss](https://discuss.flarum.org/d/39530-simple-dark-mode-flarum-2)
- [Packagist](https://packagist.org/packages/huseyinfiliz/simple-dark-mode)
- [GitHub](https://github.com/huseyinfiliz/simple-dark-mode)
- [Issues](https://github.com/huseyinfiliz/simple-dark-mode/issues)

If you liked this extension, don't forget to check out my other extensions too: [huseyinfiliz.com/flarum](https://www.huseyinfiliz.com/flarum-extensions/)

License
-------

[](#license)

Released under the [MIT License](LICENSE.md).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 83.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

49d ago

Major Versions

1.0 → 2.x-dev2026-07-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/09c355d62c7dcfc040309947946c06155947883a72b6b0c7a354c7d93453fad1?d=identicon)[huseyinfiliz](/maintainers/huseyinfiliz)

---

Top Contributors

[![huseyinfiliz](https://avatars.githubusercontent.com/u/37220000?v=4)](https://github.com/huseyinfiliz "huseyinfiliz (5 commits)")[![flarum-bot](https://avatars.githubusercontent.com/u/39334649?v=4)](https://github.com/flarum-bot "flarum-bot (1 commits)")

---

Tags

extensionflarumdark-modenight modetoggle theme

### Embed Badge

![Health badge](/badges/huseyinfiliz-simple-dark-mode/health.svg)

```
[![Health](https://phpackages.com/badges/huseyinfiliz-simple-dark-mode/health.svg)](https://phpackages.com/packages/huseyinfiliz-simple-dark-mode)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

13129.1k](/packages/flarum-lang-russian)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1941.0k](/packages/flarum-lang-french)[fof/masquerade

User profile builder extension for your Flarum forum.

2026.0k7](/packages/fof-masquerade)[fof/sitemap

Generate a sitemap

17104.0k2](/packages/fof-sitemap)[flarum/gdpr

Features for GDPR, PII management

1344.5k24](/packages/flarum-gdpr)[fof/discussion-language

Specify the language a discussion is written in & sort by language

1035.6k7](/packages/fof-discussion-language)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)