What is InstaFix?
Open-source client feedback widget — DOM-anchored annotations, self-hosted, zero SaaS fees.
InstaFix lets your clients leave feedback directly on the website you're building for them. They draw a rectangle on the page (or click the toolbar's target button and click an element), type a comment, and you receive it pinned to the exact element — no more screenshots pasted into emails, no more "the button at the top… no, the other one".
It's built for freelancers and agencies who review work-in-progress sites with clients, and it replaces tools like Marker.io or BugHerd with something you own: MIT-licensed, self-hosted, your database, zero subscription.
How it works
- You add the widget to the site under review — one
npm install, oneinitInstaFix()call. By default it only shows in development and staging, never to production visitors. - Your client annotates — draw a rectangle, or click the target button and click any element on the page. Each comment is anchored to the DOM element under it, so it survives deploys and layout changes. Optional extras: a screenshot of the annotated area, console/network diagnostics.
- You triage — in the drop-in dashboard (a Linear-style inbox with keyboard shortcuts) or through the plain HTTP API. Statuses flow
open→in_progress→resolved/wont_fix.
The pieces
| Package | What it is |
|---|---|
@instafix/widget | The feedback widget your clients use (~30 KB gzip, framework-agnostic, React hook included) |
@instafix/dashboard | The triage inbox — one React component, or a headless hook |
@instafix/adapter-prisma / -sqlite | The production server adapters: one endpoint, auth, CORS, webhooks |
@instafix/adapter-memory / -localstorage | Stores for tests, demos, and server-less prototypes |
@instafix/adapter-kit | Build your own store adapter — the contract, the engine, the conformance suite |
@instafix/cli | init, sync, status, doctor — setup and health checks |
Ready? The quickstart takes about three minutes — or try everything live in the demo, which runs this very widget.