What is SitePing?
Open-source client feedback widget — DOM-anchored annotations, self-hosted, zero SaaS fees.
SitePing lets your clients leave feedback directly on the website you're building for them. They draw a rectangle on the page (or right-click), 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, oneinitSiteping()call. By default it only shows in development and staging, never to production visitors. - Your client annotates — draw a rectangle, or right-click anywhere. 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 |
|---|---|
@siteping/widget | The feedback widget your clients use (~34 KB gzip, framework-agnostic, React hook included) |
@siteping/dashboard | The triage inbox — one React component, or a headless hook |
@siteping/server | The HTTP endpoint over any store, for any framework: auth, CORS, hooks, webhooks |
@siteping/adapter-prisma | The production server adapter: that endpoint with a Prisma store built in |
@siteping/adapter-drizzle | A production store on PostgreSQL or Turso / libSQL through Drizzle ORM |
@siteping/integration-issues | One GitHub or GitLab issue per feedback, kept in sync through the server's hooks |
@siteping/screenshot-storage | Where screenshots live — any S3-compatible bucket, Cloudflare Images, your database, the filesystem, or your own backend |
@siteping/adapter-memory / -localstorage | Stores for tests, demos, and server-less prototypes |
@siteping/adapter-kit | Build your own store adapter — the contract, the engine, the conformance suite |
@siteping/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.