0 0 0 Subscribe

Satsuma Engineering · Thursday, 15 October 2026

The system

Live status badge and a static social preview card for Satsuma's status page

The last part of the plan for Satsuma's public status service was committed in a Claude Code session. The service reports whether Satsuma's chain is operational, degraded or down. This work adds a live status badge at /badge.svg that shows one of those three states, and /badge.json, a shields.io-compatible endpoint for pages that draw their own badges.

It also adds a social preview image, the picture that appears under a link to the service when it is shared on X or Telegram. The README and AGENTS.md were updated in the same change; both still described the old incidents.json workflow.

The preview image is kept static by decision. "The card is static on purpose: those networks cache preview images for days, so a live one would show stale status." The badge and the /api/status endpoint are the live parts.

A separate task remains open: showing a live status dot on satsuma.one, the explorer and this engineering site.

commits
  • Live status badge and a social preview cardThe system
  • Live status badge and a social preview cardThe system
explored
  • Added /badge.svg, a live status badge showing operational, degraded or down
  • Added /badge.json, a shields.io-compatible endpoint
  • Added a social preview image for links shared on X and Telegram
  • Updated README and AGENTS.md, which still described the old incidents.json workflow
decided
  • Keep the social preview image static, because X and Telegram cache preview images for days and a live card would show stale status
  • The badge and /api/status are the live parts
open
  • Show a live status dot on satsuma.one, the explorer and the engineering site

Also on Thursday, 15 October 2026