Features
What Bootstrapware Comments includes
Resource-scoped threads
Scope is workspace, environment, app, tenant, resource type, and resource id. A page URL is not enough.
Flat replies
Replies belong to the thread. There is no nested conversation tree.
Plain text and safe links
Line breaks stay. An http or https token can render as a link. There is no arbitrary HTML or markdown.
Structured mentions
A mention is a host user id, up to 20 per comment. Mentioning someone does not grant access.
Unread markers
Other people's comments create unread activity. Your own comments do not. Edits, resolve, and deletion do not add a badge.
Resolve and reopen
Resolved threads stay readable. Reply requires reopen. The update checks the thread version and keeps the draft on conflict.
Edit, delete, and tombstones
Authors edit and delete their own text. Moderators can tombstone with attribution. A deleted root leaves replies in place.
Filters before pagination
All, open, resolved, and unread run on the server before the page. Default page size is 50. Maximum is 100.
Hosted live updates
Hosted subscribe is SSE with ids only. If the stream is absent or errors, the widget polls every 4 seconds.
BYO adapter
Implement the same CommentsAdapter on your API. Published config still loads with a publishable key.
Hosted store
Omit the adapter and pass app id, publishable key, and a server-minted author token. Live writes need Hosted.
Author tokens
Default lifetime is 300 seconds. Permissions are read, create, reply, edit own, delete own, resolve, and moderate.
Host theme
theme is light or dark. Hosts can set the documented CSS variables on the embed root.
App configuration
Labels, empty state, theme options, mention and resolve affordances, body limit, and allowed origins.
Configuration revisions
Draft without changing what live clients load until you publish. Removing an affordance does not delete history.
Test and live environments
bsw_test_* and bsw_live_* keys. Live config needs BYO or Hosted. Live Hosted writes need Hosted.
Operational sessions
Dashboard usage is metadata. It is not an invoice and it does not include comment bodies.
Webhooks
Seven Hosted events, HMAC-SHA256, ids only. BYO returns events to your adapter. Neither mode sends email.
Export and retention
Secret-key JSON export. Cancel Hosted: writes freeze, export for 30 days, then delete. Hosted to BYO keeps the rows.
MCP for app config
List, create, draft, publish, and the install snippet. Tools do not accept comment bodies.