HatchedDocs
ReferenceWidgets

Streak widget

A compact streak counter — flame icon, day count, progress toward next milestone.

Mount

<div
  data-hatched-widget="streak"
  data-hatched-token="SESSION_OR_EMBED_TOKEN"
  data-hatched-streak-key="daily_lesson"
></div>

Attributes

AttributeValuesDefault
data-hatched-tokensession or embed tokenrequired
data-hatched-streak-keystreak key as configuredrequired
data-hatched-layoutcompact fullcompact
data-hatched-show-milestonestrue falsetrue

Required scopes

  • buddy:read

Events

el.addEventListener('hatched:streak-milestone', (e) => {
  playConfetti(e.detail.milestone);
});

Burn animation

When the counter resets (a missed day), the widget plays a short "ember extinguish" animation. This is informational only — the reset already happened server-side.