Skip to content
Design System
GitHub

Timeline

v0.17.4

Events in time order with neutral markers, status glyphs or icons; vertical, alternate or horizontal, grouped by day.

  1. Shift started
    Patrol dog 7F3A left the dock with 98 % battery.
  2. North gate patrol done
  3. Returned to dock

Timeline default

Install
npx shadcn add @syncrobotic/timeline

Also installs: @syncrobotic/cn, @syncrobotic/status-glyph

Overview

A list of events in time order, each with a time, a marker and a title.

When to use

  • What a robot did on a shift.
  • How an incident unfolded.
  • Maintenance and release history.

Use something else

More examples

States and real uses. Each example is also a Storybook story and a visual regression test.

  1. Emergency stop pressed, failed
    Operator Lin stopped Patrol dog 7F3A from the console.
  2. Obstacle in path, warning
    Pallet blocking corridor B-4. Robot slowed to 0.3 m/s.
  3. Patrol started
  4. Docked, charged

Timeline incident

  1. Lidar cleaned
    By Chen, 6 min
  2. Battery replaced
  3. Moved to Hall B
  4. Commissioned

Timeline with icons

  1. Today
  2. Returned to dock
  3. North gate patrol done
  4. Yesterday
  5. Battery 18 %, warning
  6. Hall B patrol done

Timeline grouped by day

  1. Smoother docking
    Approach speed drops near the charger.
  2. Thermal camera support
  3. Night patrol mode

Timeline alternate

  1. Ordered
  2. Shipped
  3. On site
  4. Commissioning

Timeline horizontal

  1. Version 0.9.0
    Data gridStepperTimeline
  2. Version 0.8.0
    MCP serverMeterPagination
  3. Version 0.7.0
    Command paletteChart

Timeline release notes

Patterns

Ready-made uses of timeline with real data and copy. Each installs as source under its own name.

Activity and audit timelines

Events in time order: what a robot did on its shift, who changed what.

  • Newest first, grouped by day.
  • Only an abnormal event is coloured; an audit log is never coloured.
  • A change shows its value before and after.

Robot activity

A robot's shift, newest first and grouped by day, each event with its kind as an icon.

Install
npx shadcn add @syncrobotic/timeline-activity
Built from

Audit history

Who changed what, with the value before and after, filtered to people or the system.

Install
npx shadcn add @syncrobotic/timeline-audit

Usage rules

  • Plain events get a neutral dot. Only warning and danger events are coloured.
  • Give dateTime so the time is machine-readable.
  • Newest first for incidents and logs; oldest first for a process.

Changelog

  • 0.17.42026-11-21A warning or danger event says so to screen readers (", warning", ", failed"), as Marker does; the glyph alone was visual only.
  • 0.17.32026-11-19A horizontal timeline fades its last visible event when more are hidden (now a client component).
  • 0.15.02026-11-19The horizontal timeline shows keyboard focus again.

How to upgrade