What is co-mment?

co-mment is a drop-in commenting layer for non-production websites. You install an npm package and add one React component; anyone viewing the site can then leave positioned comments anywhere on any page: on any site, on any host, whatever you deploy with.

Comments land in a hosted dashboard where editors reply, resolve, copy threads as agent-ready prompts, or push them to Linear.

The three roles

• Commenters (clients, PMs, teammates) click the pin button, click anywhere on the page, and type. First time only, they enter a name and email. No account, no extension.
• Editors sign into the dashboard with a 6-digit email code and triage every comment across the project in one Inbox.
• Developers install the widget once and add their staging origins to the project allowlist. That’s the whole integration.

The 60-second version

npm install @planetary/co-mment
# or: pnpm add co-mment / yarn add co-mment

Then add the <Comment /> component near your app root, behind a check that keeps it off in production, and allowlist your staging origin in the dashboard. Full steps in Install.

How it stays honest

Pins are anchored to the element under the click, not to pixel coordinates, so they survive redeploys, viewport changes, and content shifts. When the page has changed enough that a pin’s position is a guess, the widget says so with a drift badge instead of placing it confidently in the wrong spot. The full model is described in Anchoring.

Where to next

• Install: React, Next.js, and Vite notes, plus how to keep it off in production.
• Anchoring: how pins find their way back.
• Widget API: the public /w/* endpoints the SDK talks to.