shrink
coming soon to the stores

Shrink will land on the Chrome Web Store and Firefox Add-ons soon. Until then, the steps below get you running in about a minute.

manual install

Install Shrink
from source.

The Chrome Web Store and Firefox Add-ons listings are coming soon. Until then, 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.2.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.