AuraDark 🌌

Premium Eye Comfort & Dark Mode Extension

AuraDark is a visually stunning, lightweight, and performance-optimized browser extension designed to protect your eyes, reduce visual fatigue, and enhance readability across the entire web. It replaces harsh white screens with beautifully balanced dark themes and customizable eye-comfort filters.

---

✨ Key Features

• 🎨 Tailored Eye-Comfort Themes: Toggle between hand-crafted color palettes designed for various lighting conditions and preferences:

  • Soft Dark: A balanced charcoal background that reduces glare without sacrificing contrast.
  • OLED Black: Pure black (#000000) pixels, perfect for battery saving on OLED screens and absolute dark environments.
  • Sepia: Warm, paper-like tones mimicking vintage books to minimize blue-light exposure.
  • Forest Sage: A soothing organic green tone that helps calm the visual cortex.
  • Warm Amber: Deep amber hues that act as a natural blue-light filter for nighttime browsing.
  • E-Paper: A high-legibility, low-contrast profile optimized for long-form reading.

• 🎛️ Real-Time Fine Tuning: Precision sliders to customize:

  • Brightness
  • Contrast
  • Sepia filter intensity
  • Grayscale saturation

• 🔒 Domain-Specific Control: Whitelist or blacklist domains. The extension automatically remembers your preferences for each site.

• ⚡ Instant Hotkeys: Toggle AuraDark globally at the press of a key without opening the popup:

  • Mac: ⌘ + Shift + D
  • Windows / Linux: Ctrl + Shift + D

• 🚀 Highly Optimized: Zero layout thrashing, fast execution at document_start, and native CSS variable injection for smooth scrolling and page loading.

---

🛠️ Installation & Setup (For Developers)

To run AuraDark locally in developer mode:

1. Clone this repository:

   git clone https://github.com/mandy321/Aura-Darkmode.git
   cd Aura-Darkmode

2. Open your browser's extensions management page:
   • Chrome: Navigate to chrome://extensions/
   • Edge: Navigate to edge://extensions/
   • Firefox: Navigate to about:debugging#/runtime/this-firefox
3. Enable Developer Mode (usually a toggle in the top-right corner).
4. Click Load unpacked and select the root folder of this project (Aura-Darkmode).

---

🎹 Keyboard Shortcuts

Shortcut	Description
Cmd + Shift + D (Mac)	Toggle dark mode on the current page
Ctrl + Shift + D (Windows/Linux)	Toggle dark mode on the current page

---

🧱 Project Structure

Aura-Darkmode/
├── manifest.json         # Extension configuration & entry points
├── background/
│   └── background.js     # Manages keyboard command listeners & extension lifecycle
├── content/
│   ├── content.js        # DOM injection, style application & storage synchronization
│   └── content.css       # Core theme filter styles & overrides
├── popup/
│   ├── popup.html        # Clean, modern UI panel structure
│   ├── popup.css         # SF-Symbols & premium glassmorphism styling
│   └── popup.js          # Controller managing UI sliders & theme selections
├── icons/                # High-res extension icons
└── test_page.html        # Interactive offline test harness

---

🛡️ License

Distributed under the MIT License. See LICENSE for more information.