Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pixel Perfect

A Chrome (Manifest V3) browser extension that overlays a design mockup image on top of a live webpage at a controllable opacity, so you can compare a rendered page against its design pixel-by-pixel.

Upload PNG/JPG/GIF mockups into a global image library, assign any of them as the active overlay for the current site, then drag, resize, and fade it to line up with the live layout. Overlay settings (image, position, size, opacity, visibility) persist per-hostname, so returning to a page restores your last alignment.

Install / setup

Requires Node.js.

npm install
npm run build

Then load the extension in Chrome:

  1. Go to chrome://extensions
  2. Enable Developer mode (top right)
  3. Click Load unpacked and select the dist/ folder

During development, run npm run watch instead of npm run build to rebuild on file changes, then click the reload icon on the extension's card in chrome://extensions after each change.

Usage

  1. Navigate to the page you're building.
  2. Click the Pixel Perfect toolbar icon to open the sidebar. It's docked to the edge of the page and stays open — across scrolling, dragging, and even navigating to other pages in the same tab — until you explicitly close it (click the toolbar icon again, or the sidebar's own close button). Click the minimize button to collapse it to a small handle, and click the handle to bring it back.
  3. Drag an image into the sidebar (or click Choose file) — it's added to your image library.
  4. Click a library image to assign it as the overlay for the current site.
  5. Adjust Opacity to blend it with the page, drag the image (or use arrow keys) to reposition it, and resize it with the corner handle or the width/height fields.
  6. Toggle visibility with the sidebar button or Alt+Shift+P to "blink" between the design and the live page.

If a mockup was exported at 2x/3x (e.g. a Retina screenshot or a Figma "@2x" export), set its Export scale in the sidebar so the overlay renders at the correct CSS-pixel size instead of twice as large as the page.

License

MIT — see LICENSE.

About

A Chrome (Manifest V3) browser extension that overlays a design mockup image on top of a live webpage at a controllable opacity, so you can compare a rendered page against its design pixel-by-pixel.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages