Docs

Add a live reactions bar to any page in two lines. Readers tap; everyone watching sees it fall, in real time.

Get a key

Request access, and once you're approved, create an app in the console. You'll get a publishable key (pk_live_…) for your embed and a secret key shown once — keep it safe, but you don't need it for the basic embed.

Paste the snippet

Drop this where the reactions bar should appear. The console's Embed panel generates it pre-filled with your key.

<script type="module" async src="https://api.tapback.party/loader.js"
  data-key="pk_live_yourkey"
  data-api="https://api.tapback.party"
></script>
<tapback-bar entity="your-page-id"></tapback-bar>

The bar renders with the reactions, colors, icons, and layout you set in the console — change them there and every embed updates, no code change needed.

Once it's live, the pages below cover the rest: how counts are scoped, every script attribute, theming, the JS API, privacy, and getting your data out.

• Entities
  How a reaction count is scoped — one counter per entity, the thing being reacted to.
• Script attributes
  Every attribute the embed script and the <tapback-bar> element accept, with defaults.
• Theming
  Set icons, colors, and layout in the console, or drive the bar from your own stylesheet with --tapback-* custom properties.
• Mute & the JS API
  The built-in mute bell, and how to drive mute yourself from your own control.
• Privacy & limits
  Anonymous readers, silent abuse handling, and a tiny embed that loads its live core lazily.
• Export your data
  One-click JSON/CSV export, a self-contained static archive that outlives us, and rendering counts as static HTML with no JavaScript.