HatchedDocs
ReferenceWidgets

Celebrate host

One-shot celebration overlay for badges, evolutions, and streak milestones.

Celebrations are exposed from the shared loader. Include the loader once, then call the host API when your product wants a moment.

<script src="https://cdn.hatched.live/widget.js" data-session-token="SESSION_TOKEN" defer></script>
window.__HATCHED_WIDGET__.celebrate({
  kind: 'badge',
  badge: {
    key: 'week_warrior',
    label: 'Week Warrior',
    description: 'Seven active days in a row',
  },
  tier: 'bloom',
});

The celebrate bundle lazy-loads only when the first celebration is fired.