HS Article

Lumino Dark Mode for WordPress

Give your visitors the dark mode experience they expect — with a single click. Lumino adds a beautiful floating toggle button to your WordPress site that works with every theme, requires zero coding, and remembers each visitor’s preference automatically.

Lumino dark mode plugin image

What Is Lumino Dark Mode?

Lumino Dark Mode is a free WordPress plugin that adds a floating dark/light mode toggle button to your website. It uses a CSS filter technique (invert + hue-rotate) applied to the entire page — meaning it works with any WordPress theme without touching your theme files. Images and videos are automatically re-corrected so they always look natural in both modes.

Features

01

Works With Any WordPress Theme

No CSS knowledge needed. Lumino applies the filter at the html element level — it works with Elementor, Divi, Astra, GeneratePress, WooCommerce, and any other theme or page builder.

02

Smart Base Theme Detection

Lumino automatically detects whether your site is light or dark. On dark sites the toggle starts in night mode. On light sites it starts in day mode. Per-page detection means mixed sites work correctly too.

03

Visitor Preference Saved

Each visitor's choice is saved in localStorage and persists across all pages and sessions automatically — no cookies, no database storage.

04

Fully Customizable

6 toggle styles to choose from
- Position: Bottom-Right, Bottom-Left, Top-Right, Top-Left
- Custom pixel offset from each edge
- Adjustable width, height, and border radius

05

No Flash on Page Load

A lightweight inline script runs before the page paints — applying the correct mode instantly so visitors never see a flash of the wrong color.

How to Install

Option 1 — From WordPress Admin

  1. Go to Plugins → Add New
  2. Search for “Lumino Dark Mode”
  3. Click Install Now → Activate
  4. Go to Lumino Dark Mode in your admin sidebar to configure

Option 2 — Manual Upload

  1. Download the zip from WordPress.org
  2. Go to Plugins → Add New → Upload Plugin
  3. Upload the zip and activate
  4. Go to Lumino Dark Mode settings to configure

Plugin Details

  1. Version: 1.1
  2. Requires WordPress: 5.8 or higher
  3. Requires PHP: 7.4 or higher
  4. Tested up to: WordPress 7.0
  5. License: GPLv2 or later
  6. Author: hsarticle

Frequently Asked Questions

Does it work with all WordPress themes?

Yes. Lumino applies a CSS filter to the entire html element which affects every part of the page regardless of your theme's structure. It works with all themes including page builders.

Will images look inverted in dark mode?

No. Images, videos, iframes, and canvas elements are automatically re-inverted so they always display in their original colors in both modes.

My site is already dark — will it work correctly?

Yes. Lumino auto-detects your site's base theme. If your site is already dark, the toggle will switch to light mode instead of making it darker. You can also force the detection in Advanced Settings.

How is each visitor's preference saved?

The preference is saved in the browser's localStorage so it persists across all pages and sessions without needing cookies or a server-side database.

Will it slow down my website?

No. Lumino loads one small CSS file and one small JS file — pure vanilla JavaScript with zero external dependencies.

Is it free?

Yes, completely free and open source under GPLv2. No premium version, no upsells.

Can I control the toggle position?

Yes. Go to Lumino Dark Mode settings and choose Bottom-Right, Bottom-Left, Top-Right, or Top-Left — plus exact pixel offsets from each edge.

Download Lumino Dark Mode Free

Lumino Dark Mode is 100% free and open source. Download it directly from the official WordPress Plugin Directory.