shrink
now on the chrome web store

Shrink is live on the Chrome Web Store — one-click install. Firefox Add-ons is coming soon; the manual steps below still work for both browsers.

add to chrome
manual install

Install Shrink
from source.

Prefer to build it yourself? Shrink is live on the Chrome Web Store, and the Firefox Add-ons listing is coming soon. Building from source takes about a minute — all you need is git, Node.js 22+ and your favourite package manager.

view on githubback home
1

Clone the repo

Get the source code from GitHub.

terminal
git clone https://github.com/matheusafd/shrink.git
cd shrink
2

Install dependencies

Requires Node.js 22+. Pick whichever package manager you prefer. Extension version: v0.3.0.

terminal
pnpm install
3

Build for Chrome

Outputs a production build to apps/extension/.output/chrome-mv3.

terminal
pnpm build:ext
4

Load it in Chrome

Chrome accepts unpacked MV3 extensions during development. The install persists across browser restarts.

  1. 1Open chrome://extensions in a new tab
  2. 2Toggle "Developer mode" on (top right)
  3. 3Click "Load unpacked"
  4. 4Select the folder apps/extension/.output/chrome-mv3
browser url
chrome://extensions
Done. Open any tab, click the Shrink icon, pick a device. Your last device and settings are remembered.

troubleshooting

Common gotchas

  • Firefox add-on disappears after restart: temporary add-ons are unloaded on browser restart. Re-run the "Load Temporary Add-on" step after every Firefox restart.
  • Wrong manifest version on Firefox: use the :firefox build script (not the Chrome one) — the Firefox build emits MV2 with DNR.
  • Icon does not appear after install: pin Shrink from the puzzle-piece menu next to your address bar.
  • Build script fails: make sure Node.js is at least 22.x. The repo .nvmrc pins the recommended version.