Skip to content

ifreqs/shadow-page-extension-ifreqs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

shadow-page-extension-ifreqs

🌑 Shadow Engine

Shadow Engine is a high-performance, minimalist background darkening tool engineered by ifreqs. It is designed to transform the blinding light of the web into a premium, eye-friendly dark experience without compromising the visual integrity of content.

Shadow Engine Banner (Placeholder)

✨ Engineering Philosophy

Shadow Engine follows a "Minimal Intervention, Maximum Impact" philosophy. Unlike heavy dark mode extensions that invert colors and break layouts, Shadow Engine focuses specifically on background surfaces.

  • 🎯 Intelligent Surface Detection: Real-time analysis of background brightness levels.
  • 💎 Pure Background Focus: Targets only the surfaces, leaving images, videos, and UI accents in their original state.
  • 🧠 Adaptive Text Correction: Automatically ensures text remains readable by boosting contrast when a background is darkened.
  • ⚡ Zero Latency: Built with an optimized MutationObserver system to handle dynamic content without lag.
  • 🛡️ Privacy Guaranteed: Works entirely on-device. No tracking, no external API calls, no data storage.

🚀 Installation

  1. Clone/Download this repository.
  2. Open your browser (Chrome, Brave, Opera, or Edge).
  3. Go to chrome://extensions/.
  4. Enable "Developer mode".
  5. Click "Load unpacked" and select the shadow-engine folder.

🛠 Usage

  • Toggle: Click the extension icon to access the Shadow Engine control center.
  • Status: Quickly see if the engine is "Active" or on "Standby".
  • Persistence: Your preferences are saved automatically across all tabs and sessions.

📁 Technical Architecture

  • manifest.json: Core configuration for modern browsers (V3).
  • content.js: The "Engine" - handles real-time DOM processing and brightness detection.
  • content.css: The "Design System" - provides premium dark tokens and layout resets.
  • popup.html/js: The Control Center with a high-end UI/UX.

📜 License & Copyright

Copyright (c) 2026 ifreqs. All rights reserved.

This software is provided under the MIT License.

Permission Notice

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software...

(Full license text available in the LICENSE file)


Created with architectural precision by ifreqs

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors