Documentation

Install the widget

Create a project in the dashboard to get a real ss_live_… key, then paste the matching snippet into your prototype.

Snippet

<script
  async
  src="https://www.smokesignal.design/v1/widget.js"
  data-smokesignals-key="ss_live_YOUR_KEY"
></script>

Place before </body> in your HTML.

Verify install

Deploy with the snippet, visit your site, then watch the Setup tab flip to Installed ✓ when widget.ping fires.

Review mode

From the project Setup or Review links tab, copy a review URL. It appends ?ss_review=… to your prototype so you see every pin overlayed on the live page — with resolve and reply actions inline.

Privacy model

Commenters only see threads from their own device token (localStorage).
Creators see everything in the dashboard.
In-page review mode (signed link) sees all pins on the current page.

Limitations

Mobile commenting works but is not optimized.
Iframe-embedded prototypes are unsupported.
Heavily dynamic layouts may drift pins — review mode and the thread panel remain the escape hatch.