=== Nightly Dark Mode ===
Contributors: badhonrocks, plugpressco
Tags: dark mode, night mode, dark theme, eye care
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Nightly Dark Mode customizable dark mode plugin for site that allows you to easily add a dark theme.
== Description ==
Nightly Dark Mode adds dark mode to your website in one click. Give visitors a more comfortable viewing experience with automatic dark mode that can help reduce eye strain. With customizable color schemes, scheduling options, and a floating toggle button, Nightly makes it easy to offer a dark theme for your site.
= Why Dark Mode? =
Dark mode makes your site more comfortable to browse in low light. Many users prefer it at night, and OLED screens may use less power with darker colors. It also gives your site a modern look.
= How It Works =
Nightly applies a smart CSS-based filter to create a dark version of your site when dark mode is enabled. Visitors can switch between light and dark using a floating toggle button, or you can enable automatic scheduling based on the time of day. The plugin also intelligently re-inverts images and media so they look correct in dark mode.
= Key Features =
**6 Color Themes**
Choose from Classic, Cool, Warm, High Contrast, Pure Black (OLED), or create your own custom colors.
**Smart Auto-Scheduling**
Automatically enable dark mode during evening hours (e.g., 8 PM to 6 AM).
**Customizable Toggle Button**
3 styles (Classic, Pill, Minimal) with 5 size options that float on your site.
**Smooth Transitions**
Adjustable fade animations when switching between light and dark modes.
**Keyboard Shortcuts**
Let power users toggle dark mode with customizable keyboard shortcuts.
**Per-Page Control**
Disable dark mode on specific pages, such as landing pages or photo galleries.
**Media Controls**
Individual brightness adjustments for images, videos, and backgrounds.
**Performance Optimized**
Lightweight and fast with no impact on page speed.
== Installation ==
1. Go to **Plugins → Add New** in your WordPress admin
2. Search for "Nightly Dark Mode."
3. Click **Install** and then **Activate**
4. Navigate to **Settings → Nightly** to configure
5. Enable dark mode and customize your preferences
= Build from Source =
To build the plugin from source, clone the repository and install dependencies:
`git clone https://github.com/plugpress-io/nightly.git`
`cd nightly`
`npm install`
`npm run build`
== Frequently Asked Questions ==
= Does it work with my WordPress theme? =
Yes! Nightly works with any WordPress theme using universal CSS filters. We've tested it with popular themes like Astra, GeneratePress, Kadence, and Divi.
= Will it slow down my site? =
No. Nightly is performance-optimized with minimal CSS and JavaScript. It won't affect your page speed scores.
= Can visitors toggle dark mode on/off? =
Yes! A customizable toggle button appears on your site that visitors can click. Their preference is saved automatically.
= Does it work on mobile devices? =
Yes! Nightly is fully responsive and works perfectly on desktops, tablets, and smartphones.
= Can I customize the colors? =
Yes! Choose from 6 pre-built themes or create your own custom color palette with our color picker.
= Will dark mode break my images? =
No! Nightly intelligently re-inverts images, videos, and media so they display correctly in dark mode.
= Can I schedule dark mode for specific hours? =
Yes! Enable auto-scheduling to automatically activate dark mode during evening hours (e.g., 8 PM to 6 AM).
= Is it accessible? =
Yes! Nightly is WCAG 2.1 compliant with keyboard navigation, screen reader support, and a high-contrast mode.
= Does it collect any data? =
No. Nightly is 100% GDPR compliant with no external API calls or data collection. All settings are stored locally.
= How do I disable dark mode on specific pages? =
Use the "Dark Mode Settings" meta box in the post/page editor to disable dark mode for specific content.
== Screenshots ==
1. Admin Settings
2. Toggle button customization
3. Six beautiful color theme options
== Changelog ==
= 1.0.2 =
* Added 6 color scheme variants (Classic, Cool, Warm, High Contrast, Pure Black, Custom)
* Added auto-scheduling with custom time ranges
* Added per-page dark mode control with meta boxes
* Added customizable keyboard shortcuts
* Added smooth transitions with adjustable duration
* Added individual media brightness controls (images, videos, backgrounds)
* Improved live preview with real-time updates
* Fixed toggle button icon visibility issues
* Performance optimizations
* WCAG 2.1 accessibility improvements
= 1.0.1 - 2025-01-15 =
* Initial release
== Upgrade Notice ==
= 1.0.2 =
Major update! Adds 6 color schemes, auto-scheduling, per-page control, keyboard shortcuts, and media brightness controls. Highly recommended upgrade.