Skip to content

carlos-camara/visionary-pr-diff

Visionary PR Diff

Visionary PR Diff Logo

The advanced pixel-level image regression analysis engine for modern GitHub Pull Requests.

Version License Status


🚀 Explore Professional Capabilities


Visionary PR Diff Demo

Surgical precision in every pixel. Clarity in every Pull Request.


✨ Key Features

  • 🧠 Pixel-Level Intelligence: Automatically identifies and highlights exact pixel modifications between original and updated images.
  • 🛡️ Quality Guardrails: Prevents accidental UI regressions by providing absolute clarity in Pull Request reviews.
  • ✨ Premium Integration: Seamlessly injects a high-fidelity "Visual Diff" button into the standard GitHub UX.
  • 🚥 Enterprise Standards: Built with Manifest V3 and styled with a sleek glassmorphism aesthetic for top-tier performance.

⚙️ How It Works

  1. DOM Observation: The engine monitors GitHub's "Files changed" section for image modifications.
  2. Action Injection: A surgical Visual Diff button is injected into the header of every detected image file.
  3. Canvas Processing: Upon activation, the engine extracts the "Before" and "After" images and processes them through an HTML5 Canvas-based bitwise comparison.
  4. Visual Result: A high-fidelity modal overlay renders the difference map, highlighting changes in surgical magenta.

🍱 Advanced View Modes

Visionary PR Diff provides three distinct modes of analysis to ensure no visual regression goes undetected:


📐 1. The "Default 2-up" (Side-by-Side)

2-up Comparison The classic architectural comparison. Ideal for verifying general layouts and structural integrity where side-by-side context is paramount.


💎 2. The "Visionary 3-up" (Symmetrical Differential)

3-up Comparison Our flagship mode. Provides perfect architectural symmetry by rendering the Source, Difference Map (Surgical Magenta), and Target in a single, high-fidelity view. This is the gold standard for pixel-perfect verification.


↔️ 3. The "Dynamic Swipe" (Interactive Overlay)

Swipe Comparison An interactive slider that allows you to "wipe" the new version over the old one. Perfect for detecting subtle 1-pixel shifts or font-rendering changes that side-by-side views might miss.



🛠️ Installation & Setup

Click to expand installation steps
  1. Clone the repository to your local machine.
  2. Open Chrome and navigate to chrome://extensions/.
  3. Enable Developer mode (toggle in the top right corner).
  4. Click Load unpacked and select the repository directory.
  5. Watch the magic happen on your next GitHub PR with images!

🤝 Community & Development

We value professional contributions. Maintain the highest standards of engineering excellence by following our guidelines:

Resource Description
Contributing How to help improve the engine.
Changelog Tracking our progress and releases.
Security Our commitment to vulnerability management.
Code of Conduct Maintaining a professional environment.

⚖️ License

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


Part of the Visionary Engineering Suite by Carlos Camara

Releases

No releases published

Packages

 
 
 

Contributors