Community project. This is not an official government website.

Run by volunteers. Lampung Design System is built by an open source community. No government agency runs or endorses it.

Official services use go.id. Government websites in Indonesia end in .go.id. Never enter your national ID number on a site you are unsure of.

Status dot

Status dot

An 8 px colored dot followed by words, for the live state of a system, a service or a connection. The words say the state; the dot helps scanning.

Usage

Use it when

  • The health or state of something that runs: a service is up, a sync is delayed, a classroom stream is live.
  • A column of states in a table or a list where a dot speeds up scanning ("Running", "Stopped").

Use something else when

  • The state of a record (Draft, Overdue, Approved): use Badge.
  • A number of waiting items: use Count.
  • A person is online: use Avatar. Use .avatar__presence on the avatar.
  • A message about the whole app being offline: use Banner.

Where it goes. Inline, where the state is read: in a table cell, at the end of a list row, in a card header, in a footer ("All systems running"). The dot always comes before its words.

Examples

StatesNeutral for unknown or stopped, then ok, warning, down and live.
Not started All systems running Grade sync delayed Payments unavailable Live now
<div class="docs-col" style="max-width: 320px;">
  <span class="status"><i aria-hidden="true"></i>Not started</span>
  <span class="status status--ok"><i aria-hidden="true"></i>All systems running</span>
  <span class="status status--warn"><i aria-hidden="true"></i>Grade sync delayed</span>
  <span class="status status--down"><i aria-hidden="true"></i>Payments unavailable</span>
  <span class="status status--live"><i aria-hidden="true"></i>Live now</span>
</div>
In a listAt the end of each row, so the states line up.
Exam room A
32 candidates
Live
Exam room B
28 candidates
Starting late
Exam room C
Closed
Ended
<div class="list" style="max-width: 420px;">
  <div class="lrow"><div class="lrow__body"><div class="lrow__title">Exam room A</div><div class="lrow__sub">32 candidates</div></div><span class="status status--live"><i aria-hidden="true"></i>Live</span></div>
  <div class="lrow"><div class="lrow__body"><div class="lrow__title">Exam room B</div><div class="lrow__sub">28 candidates</div></div><span class="status status--warn"><i aria-hidden="true"></i>Starting late</span></div>
  <div class="lrow"><div class="lrow__body"><div class="lrow__title">Exam room C</div><div class="lrow__sub">Closed</div></div><span class="status"><i aria-hidden="true"></i>Ended</span></div>
</div>

Anatomy

PartWhat it is
.statusRequired. Inline flex row, 8 px gap, 14 px body text.
iRequired. The 8 px dot, neutral by default.
.status--ok|warn|down|liveThe state: success, warning, danger, or success with a short pulse.
textRequired. The state in words.

Variants and sizes

Class or attributeWhen
statusNeutral dot: unknown, ended, off.
status--okRunning, healthy, connected.
status--warnDegraded, delayed, starting late.
status--downStopped, failed, unavailable.
status--liveHappening now; the dot pulses three times when it appears.

Motion and microinteractions

  • status--live pulses a ring out of the dot (lds-live, 1.8 s on --ease-inout) three times, then stays still. A forever pulse turns into noise.
  • A state change swaps the dot color directly; change the words with text morph if it happens in view.
  • Reduced motion: the pulse plays once in 1 ms (effectively none).

Accessibility

  • The dot is aria-hidden="true"; the words are the state.
  • If the state changes while the page is open and it matters (service went down), announce it with a role="status" line, not by making each dot live.

Do and don't

Do

  • Write the state in plain words ("Payments unavailable").
  • Use the same four meanings everywhere.

Don't

  • Show a dot without words.
  • Use it for record states like Draft or Paid; use a badge.
  • Make the live pulse loop forever.