# SYNCROBOTIC Design System > A robotics UI kit for React: emergency stop, teleoperation, robot map, camera feed, LiDAR point cloud, URDF robot model and alarms, with design tokens, a high-contrast mode, colour-blind-safe charts and ready-made screens, shipped as a shadcn/ui registry for Tailwind CSS v4. Install rule: every item installs with the shadcn CLI as `@syncrobotic/` (`npx shadcn add @syncrobotic/`), as source the project owns. Start with the theme: `npx shadcn add @syncrobotic/syncrobotic-theme`. Every page below also answers as plain markdown at its URL plus `.md`: what the item is, when to use it, when not to (and what to use instead), rules, keyboard, agent notes, install command and version. Agents: install the workflow and the rules as a skill with `npx shadcn add @syncrobotic/agent-skill` (it lands in `.claude/skills/syncrobotic-ui/`). MCP: the same content as tools (search, get_item, get_install_command, get_design_language, get_checklist) at https://design-system.syncrobotic.me/mcp (Streamable HTTP). Claude Code: `claude mcp add --transport http syncrobotic https://design-system.syncrobotic.me/mcp`. ## Foundations Each foundation's `.md` twin carries the whole design language. - [Principles](https://design-system.syncrobotic.me/docs/foundations/principles.md): Five decisions every screen inherits. - [Colour](https://design-system.syncrobotic.me/docs/foundations/color.md): Semantic tokens, one meaning per colour, paired foreground and tint. - [Typography](https://design-system.syncrobotic.me/docs/foundations/typography.md): Nine sizes on a 4 px rhythm, three weights, tabular numbers. - [Spacing](https://design-system.syncrobotic.me/docs/foundations/spacing.md): A 4 px base and six steps. Nothing in between. - [Radius](https://design-system.syncrobotic.me/docs/foundations/radius.md): Six steps that keep nested corners concentric. - [Elevation](https://design-system.syncrobotic.me/docs/foundations/elevation.md): Three layers: surface, float, overlay. - [Motion](https://design-system.syncrobotic.me/docs/foundations/motion.md): Movement only marks a change of state. - [Iconography](https://design-system.syncrobotic.me/docs/foundations/iconography.md): Lucide at three sizes, always with a name. - [Accessibility](https://design-system.syncrobotic.me/docs/foundations/accessibility.md): Contrast, target size, focus and motion, checked at build time. - [Alarms](https://design-system.syncrobotic.me/docs/foundations/alarms.md): Three priorities, one lifecycle, and which surface each message belongs on. - [Data visualisation](https://design-system.syncrobotic.me/docs/foundations/data-visualisation.md): The form first, colour by job, a palette checked for colour blindness. - [Icon set](https://design-system.syncrobotic.me/icons): the 168 Lucide icons the kit uses, one meaning each. Full list in llms-full.txt. ## Blocks: Application › App shell - [App shell](https://design-system.syncrobotic.me/blocks/app-shell.md): The frame of an internal tool: collapsible sidebar (a drawer on phones), top bar with title, environment, search and user, and the page. - [Top-bar shell](https://design-system.syncrobotic.me/blocks/top-bar-shell.md): The frame for a tool or site without a sidebar: links, search and user in a top bar that starts on the content's edge and gathers into a floating panel as wide as the content column on scroll, then the content and a footer. - [Action-rail shell](https://design-system.syncrobotic.me/blocks/action-rail-shell.md): A page whose right column holds only the next step: its title, what it does, one large primary button and a few small actions. A bar fixed to the bottom on phones; ← or Esc goes back up a level. - [Phone shell with tabs](https://design-system.syncrobotic.me/blocks/app-shell-mobile-tabs.md): A phone frame: the page title on top and up to four sections as tabs in a floating dock, in thumb reach. ## Blocks: Application › Stats - [KPI cards](https://design-system.syncrobotic.me/blocks/stats-cards.md): Four headline numbers with change and sparkline. Trend colour follows whether the change is good, not its direction. - [Levels](https://design-system.syncrobotic.me/blocks/stats-meters.md): Levels in a fixed range, one per card: a bar for how full, the number for exactly, colour only past a line. - [KPIs with a range](https://design-system.syncrobotic.me/blocks/stats-filtered.md): A KPI row that follows a site and a time range chosen above it, each change compared with the period before. ## Blocks: Application › Card - [Robot status card](https://design-system.syncrobotic.me/blocks/robot-status-card.md): One robot on a phone: state, battery, connection, location, current task and the next actions. - [Site cards](https://design-system.syncrobotic.me/blocks/card-site.md): Sites to pick from: each card one link, state first, robots and missions, and what needs someone in words. - [Mission cards](https://design-system.syncrobotic.me/blocks/card-mission.md): A mission's state, route, robot and progress, with the next action; a paused one says why and offers the fix. ## Blocks: Application › Sign-in - [Sign in](https://design-system.syncrobotic.me/blocks/sign-in.md): Company SSO first, email link as the fallback; one column, errors under the field, a confirmation that says where the link went. - [Passkey sign-in](https://design-system.syncrobotic.me/blocks/auth-passkey.md): Sign in with a passkey, with a code from an authenticator app as the way back in on the same page. - [Accept an invitation](https://design-system.syncrobotic.me/blocks/auth-invite.md): Who invited you, to what, and what the role lets you do, then one field and one action to join. - [Two-factor sign-in](https://design-system.syncrobotic.me/blocks/auth-2fa.md): The step after the password: a 6-digit code or a recovery code, remember this browser for 30 days, errors and a pause in words, a passkey as the quicker way. ## Blocks: Application › Settings - [Settings page](https://design-system.syncrobotic.me/blocks/settings-page.md): Sections beside their explanation; switches apply at once, text fields collect into a save bar that appears only when something changed; a danger zone that names the consequence. - [Notification matrix](https://design-system.syncrobotic.me/blocks/settings-notifications.md): Events by channel as checkboxes that apply at once; emergency stops are locked on and say so. - [API keys](https://design-system.syncrobotic.me/blocks/settings-api-keys.md): Create, list and revoke API keys: a new secret shown once with a copy button, revoking confirmed first. - [Webhooks](https://design-system.syncrobotic.me/blocks/settings-webhooks.md): Endpoints with their events and state, adding one with its signing secret shown once, test events, recent deliveries, rotating and deleting. - [Signed-in browsers](https://design-system.syncrobotic.me/blocks/settings-sessions.md): Where you are signed in, as browsers: sign one out, or all the others after a confirmation; browsers that skip the 2FA code for 30 days. - [Plan and billing](https://design-system.syncrobotic.me/blocks/settings-billing.md): Plan and renewal, robots and seats against what the plan includes, this period's usage, the card on file (brand and last four) and invoices with their PDFs; cancelling confirms first. No checkout or card form: those stay on your payment provider's pages. ## Blocks: Application › Notifications - [Notification center](https://design-system.syncrobotic.me/blocks/notification-center.md): The bell in the top bar with its unread count, opening notifications grouped by day: a popover on wide screens, a bottom sheet on phones. Mark one or all as read, filter unread. For things worth knowing later; alarms that need action stay with Alarm and the island. ## Blocks: Application › Form - [Create and edit form](https://design-system.syncrobotic.me/blocks/record-form.md): One column, labels above fields, errors in the hint line on submit with focus on the first, the primary action names the result. ## Blocks: Application › Empty and error states - [Status pages](https://design-system.syncrobotic.me/blocks/status-pages.md): Not found, no access, error, offline and loading: what happened, why, and the next step. Never a dead end. ## Blocks: Application › Landing - [Marketing hero](https://design-system.syncrobotic.me/blocks/marketing-hero.md): Landing page hero with eyebrow, headline, two calls to action and a product visual. ## Blocks: Application › Wizard - [Add a robot](https://design-system.syncrobotic.me/blocks/wizard-commission.md): Adding a robot in four steps: identify, place, a live self-check, and a name. - [Import a file](https://design-system.syncrobotic.me/blocks/wizard-import.md): Import a CSV in three steps down the page: choose it, match its columns, check the rows and import. ## Blocks: Solutions › Fleet operations - [Fleet table](https://design-system.syncrobotic.me/blocks/fleet-table.md): Search, filter by state, paginate and act on rows. Status as shape plus word, low battery in warning. - [Operations console](https://design-system.syncrobotic.me/blocks/console-overview.md): App shell with fleet numbers, the robot table and the alarm list on one screen. - [List and detail](https://design-system.syncrobotic.me/blocks/list-detail.md): App shell with a filterable robot list and a detail pane; on phones the detail replaces the list. - [Event log](https://design-system.syncrobotic.me/blocks/event-log.md): App shell with time, level and text filters, an event table and a side sheet for one event. - [Map workspace](https://design-system.syncrobotic.me/blocks/map-workspace.md): App shell with the site map edge to edge and floating trays for the selected robot, the top alarm and the emergency stop. - [Mission schedule](https://design-system.syncrobotic.me/blocks/mission-schedule.md): A night's missions in lanes per robot: done muted, running blue, planned outlined, and a conflict explained in words. ## Blocks: Solutions › Data operations - [Data catalog](https://design-system.syncrobotic.me/blocks/data-catalog.md): Datasets one row each: filter by tier, use and task (a drawer on phones), search, sort. Only restricted tiers carry colour. - [Dataset detail](https://design-system.syncrobotic.me/blocks/dataset-detail.md): One dataset: release verdict, open issues, counts and splits, an annotated browse grid with layer toggles, lineage and compliance. - [Review queue](https://design-system.syncrobotic.me/blocks/review-queue.md): Review items one at a time by keyboard: progress, the image with its question and caption, and a key bar ([1] Yes, [2] No, [3] Skip, Esc back, ⌫ undo, ? shortcuts) whose keys go down as they are pressed. - [Governance to-do](https://design-system.syncrobotic.me/blocks/governance-todo.md): What needs a maintainer or the compliance reviewer, most blocking first; done items leave the list. ## Blocks: Solutions › Users and access - [Users and roles](https://design-system.syncrobotic.me/blocks/users-roles.md): Who can do what: change a role in place, invite by email in a dialog, remove from the row menu with undo. - [Invitations](https://design-system.syncrobotic.me/blocks/users-invitations.md): Invite in one row with what the role allows, then the pending list: expired ones say so, revoking can be undone. - [Audit log](https://design-system.syncrobotic.me/blocks/users-audit-log.md): Who did what, when and from where, narrowed by person and kind, with values before and after; exports what is shown. ## Blocks: Solutions › Incidents - [Incident queue](https://design-system.syncrobotic.me/blocks/incident-queue.md): Open incidents, unowned first, then by severity and age; severity has a shape and a number, and nobody-owns-it is a button. - [Incident](https://design-system.syncrobotic.me/blocks/incident-detail.md): One incident: its state as steps, the facts, and updates newest first; posting an update can move it on. ## Blocks: Solutions › Maintenance - [Service due](https://design-system.syncrobotic.me/blocks/maintenance-due.md): Service coming due by hours run: a meter per robot that turns amber near its interval and red past it, overdue first. - [Work order](https://design-system.syncrobotic.me/blocks/maintenance-work-order.md): A work order at the bench: steps as a checklist, parts used, notes, and sign-off that says why it is not ready yet. ## Blocks: Solutions › Firmware rollout - [Rollout in progress](https://design-system.syncrobotic.me/blocks/rollout-overview.md): A firmware rollout while it runs: its stage, the gates that pause it, and the robots in the stage, failures first. - [Plan a rollout](https://design-system.syncrobotic.me/blocks/rollout-plan.md): Version, stages with share and watch time, update window and safety, with what will happen said in plain words. ## Blocks: Solutions › AI agents - [Agent runs](https://design-system.syncrobotic.me/blocks/agent-runs.md): What the AI agents did: each run's goal, trigger and state; one waiting for approval comes first with the only button. - [Agent run trace](https://design-system.syncrobotic.me/blocks/agent-trace.md): One agent run step by step as a waterfall: tools called, inputs and outputs, a warning and what the agent did about it. - [Approve an agent's proposal](https://design-system.syncrobotic.me/blocks/agent-approval.md): An agent's proposed change, before and after per robot, why, and what it does not know; approve or send back with a reason. ## Components: Actions - [Button](https://design-system.syncrobotic.me/docs/components/button.md): Primary, secondary, outline, ghost, destructive and link; 36, 44 and 48 px; loading state with a delayed spinner. - [Segmented control](https://design-system.syncrobotic.me/docs/components/segmented-control.md): Switch between views of the same data. The selected segment is inverted. - [Toggle](https://design-system.syncrobotic.me/docs/components/toggle.md): An on/off button for a layer or option. On is inverted, like a selected segment. - [Copy button](https://design-system.syncrobotic.me/docs/components/copy-button.md): Copies a value; the icon becomes a check for 1.5 s. - [Button group](https://design-system.syncrobotic.me/docs/components/button-group.md) (beta): Buttons, a field or a menu joined into one strip: split buttons, steppers, prev / next, search with scope. - [Toggle group](https://design-system.syncrobotic.me/docs/components/toggle-group.md) (beta): A set of toggles, one or many on, joined or spaced, outline or ghost. On is inverted. - [Theme toggle](https://design-system.syncrobotic.me/docs/components/theme-toggle.md): Light, match the system, or dark: three icon segments, the current one inverted, each named for screen readers. ## Components: Inputs - [Input](https://design-system.syncrobotic.me/docs/components/input.md): 44 px text field with 16 px text so iOS does not zoom; aria-invalid turns the edge danger. - [Input group](https://design-system.syncrobotic.me/docs/components/input-group.md): An input with an icon, a unit or a button (clear, show password) inside its edge. The group draws the field, focus and error. - [Number field](https://design-system.syncrobotic.me/docs/components/number-field.md) (beta): A number with a range, a step and a unit. Type freely, kept in range on blur; 44 px buttons; arrow keys, Shift, PageUp/PageDown, Home/End. - [Textarea](https://design-system.syncrobotic.me/docs/components/textarea.md) (beta): Multi-line text field. - [Label](https://design-system.syncrobotic.me/docs/components/label.md): Accessible label for any control. - [Field](https://design-system.syncrobotic.me/docs/components/field.md): Label, control and one line for the hint or the error, with ids and aria wired up. - [Form](https://design-system.syncrobotic.me/docs/components/form.md) (beta): A form to copy and change: React Hook Form's Controller around the kit's Field, a zod schema, focus on the first error, server errors on a field or the form, a submit button that waits. No form wrapper component. - [Checkbox](https://design-system.syncrobotic.me/docs/components/checkbox.md): Checked, unchecked and indeterminate. - [Radio group](https://design-system.syncrobotic.me/docs/components/radio-group.md): Pick exactly one of a few visible options. - [Switch](https://design-system.syncrobotic.me/docs/components/switch.md) (beta): On is the primary colour, off a neutral track; takes effect immediately. - [Choice field](https://design-system.syncrobotic.me/docs/components/choice-field.md): A choice as a whole tappable row (checkbox, radio or switch with label, description and count); FieldSet groups them under one question. - [Select](https://design-system.syncrobotic.me/docs/components/select.md): Pick one from a longer list. - [Slider](https://design-system.syncrobotic.me/docs/components/slider.md): Single value or range. - [Chip group](https://design-system.syncrobotic.me/docs/components/chip-group.md): One choice among several as chips with counts, folded after N; or links, so a filter lives in the URL. Selected is inverted. - [Filter form](https://design-system.syncrobotic.me/docs/components/filter-form.md): Filters kept in the URL: a GET form that applies itself after typing stops or at once on a pick, resets the page, and works without JavaScript. - [Filters](https://design-system.syncrobotic.me/docs/components/filters.md) (beta): A query people build from chips: + Filter picks a field, an operator and a value; each rule is a chip whose parts reopen that step. Rules combine with AND, live in the URL and filter rows in the browser. - [Search field](https://design-system.syncrobotic.me/docs/components/search-field.md): The tool's one search box: / focuses it, Enter opens the results page, and on that page it follows ?q= and applies as you type. - [Autocomplete](https://design-system.syncrobotic.me/docs/components/autocomplete.md) (beta): A text field that suggests as you type: filter, arrows, Enter, groups, server search with loading. - [Input OTP](https://design-system.syncrobotic.me/docs/components/input-otp.md) (beta): A one-time code or PIN, one 44 px box per character, with paste and SMS autofill. - [Phone input](https://design-system.syncrobotic.me/docs/components/phone-input.md) (beta): A phone number with its country, formatted as you type, stored as E.164. - [Calendar](https://design-system.syncrobotic.me/docs/components/calendar.md) (beta): A month grid for one day, several days or a range; 36 px days with a mouse, 44 px on touch. - [Date selector](https://design-system.syncrobotic.me/docs/components/date-selector.md) (beta): DatePicker and DateRangePicker: a field that opens a calendar, with presets and clear. - [Time picker](https://design-system.syncrobotic.me/docs/components/time-picker.md) (beta): TimePicker (slots in a popover) and TimeInput (typed), on a 24-hour "HH:mm" value. - [Sortable](https://design-system.syncrobotic.me/docs/components/sortable.md) (beta): A list or grid people reorder by dragging a handle, by touch or by keyboard, with announcements (dnd-kit). - [File upload](https://design-system.syncrobotic.me/docs/components/file-upload.md) (beta): A drop zone that is also a button: checks type, size and count, and says what it refused. - [Questionnaire](https://design-system.syncrobotic.me/docs/components/questionnaire.md) (beta): A short set of questions, one per page or all on one form: single and multiple choice, scales and text, required checks and a review page. ## Components: Robotics - [Emergency stop](https://design-system.syncrobotic.me/docs/components/stop-button.md) (beta): One touch stops; hold 2 s to stop all; lying down it becomes wake and stand up. UI only: sending and the Bluetooth fallback live in the app. - [Slide to release](https://design-system.syncrobotic.me/docs/components/slide-to-release.md) (beta): Past 85% releases, short of that springs back in 200 ms; locked for viewers; hold 2 s on the keyboard instead. - [Teleop pad](https://design-system.syncrobotic.me/docs/components/teleop-pad.md) (beta): Drive a mobile robot by hand with a dead-man stick: it moves only while held and stops the moment input is let go or lost. Fixed-rate commands, dead zone, speed cap, keyboard. - [Robot map](https://design-system.syncrobotic.me/docs/components/robot-map.md) (beta): A site floor plan in metres, drawn in SVG with no map library: a ROS occupancy grid and costmap as the floor, laser scans, zones as outlines with icon and name, planned and travelled routes, robots as status shapes with heading and name, selection, pan and zoom by drag, wheel, pinch, buttons and keys, a scale bar and an optional north arrow; goal, waypoint and zone editing by pointer and keys; RobotMapList shows the same robots as text. - [Camera feed](https://design-system.syncrobotic.me/docs/components/camera-feed.md) (beta): A robot's live camera over a native video the app feeds (a WebRTC stream or a URL): Live with the latency, Stalled with the last frame's time when frames stop, Paused while the view is frozen here, connecting, offline and no-camera states; pause view, snapshot, mute and full screen; overlays drawn over the picture. - [Joint state](https://design-system.syncrobotic.me/docs/components/joint-state.md) (beta): A robot arm's joints for monitoring (ROS sensor_msgs/JointState with the URDF's limits): each joint's position in degrees or millimetres on a thin track between its limits, velocity and effort, near-limit and at-limit in words with an icon, and loading, empty and stale states. - [Point cloud](https://design-system.syncrobotic.me/docs/components/point-cloud.md) (beta): A LiDAR or depth point cloud (a decoded ROS PointCloud2) drawn with raw WebGL2 and no 3D library: coloured by height or intensity on the accent's single-hue ramp with its scale, a recessive ground grid, the robot at the origin and an axes gizmo in words; orbit, pan and zoom by pointer, touch and keyboard; loading, empty, error, stale and no-WebGL states. - [Robot model](https://design-system.syncrobotic.me/docs/components/robot-model.md) (beta): A robot's pose in 3D from its URDF and live joint values (ROS sensor_msgs/JointState), for monitoring: neutral greys from the theme, a ground grid and axes named in words; highlighted joints in a status colour with a callout naming them; orbit, pan and zoom by pointer and keys; loading, error with the failing file, empty, stale and no-WebGL states in words. The kit's one three.js item. ## Components: Robot shell - [Tray](https://design-system.syncrobotic.me/docs/components/tray.md) (beta): The shared frame of the dynamic island and the dock: radius 24, padding 8, gap 8. - [Dock](https://design-system.syncrobotic.me/docs/components/dock.md) (beta): Three tiers: state action, this page's primary action, navigation. - [Dynamic island](https://design-system.syncrobotic.me/docs/components/island.md) (beta): Name, device status and notifications, each zone expanding on its own; notices and the most urgent unacknowledged alarm live inside the island. ## Components: Data display - [Status glyph](https://design-system.syncrobotic.me/docs/components/status-glyph.md): Status as shape plus colour: filled circle in progress, hollow circle normal, triangle attention, square stopped, slashed circle offline. - [Status eyebrow](https://design-system.syncrobotic.me/docs/components/status-eyebrow.md): The state word above a headline, and the same status inside a list row. - [Grouped list](https://design-system.syncrobotic.me/docs/components/list.md): One surface with inset dividers; icons only when they carry meaning; status as shape plus word. - [Code block](https://design-system.syncrobotic.me/docs/components/code-block.md) (beta): Code or a command with a copy button: wraps a command between words, scrolls source sideways, hides a one-time secret until shown. Takes a highlighter's output as children. - [Badge](https://design-system.syncrobotic.me/docs/components/badge.md): Status tones as foreground on subtle tint, plus outline; CountBadge for a count and ResultBadge for a pass, a fail or too few samples. - [Avatar](https://design-system.syncrobotic.me/docs/components/avatar.md): A person (round) or a robot, site or team (square), by picture, initials or icon, in four sizes, with a status or count badge and overlapping groups that fold into +N. - [Description list](https://design-system.syncrobotic.me/docs/components/description-list.md): Label and value pairs about one thing, plain or as tiles. - [Text diff](https://design-system.syncrobotic.me/docs/components/text-diff.md) (beta): Where two texts differ, word by word: insertions a grey block with an underline, removals struck through, each announced to screen readers. Inline or side by side, with a +3 words, −1 word summary. - [Meter](https://design-system.syncrobotic.me/docs/components/meter.md): A level within a known range, neutral until it crosses a threshold; inline for table cells. - [Metric card](https://design-system.syncrobotic.me/docs/components/metric-card.md) (beta): One headline number on a card: label, value, change and context, coloured only when the change is for the worse; a link, loading and unavailable state, and MetricGrid for the row. - [Table](https://design-system.syncrobotic.me/docs/components/table.md): Dense rows for dashboards with tabular numbers. - [Graph](https://design-system.syncrobotic.me/docs/components/graph.md) (beta): A directed acyclic graph for lineage and pipelines, laid out in layers with no layout library: boxes with name, meta, status and link, neutral edges, the selected node's path highlighted, arrow keys along the edges, and GraphList, the same graph as text. - [Item](https://design-system.syncrobotic.me/docs/components/item.md): A row of content: media, title and description, and trailing actions. Links draw the hover fill. - [Icon tile](https://design-system.syncrobotic.me/docs/components/icon-tile.md) (beta): A square or round surface behind one icon, in five surfaces and four sizes, with an optional status dot. - [Kbd](https://design-system.syncrobotic.me/docs/components/kbd.md): A keyboard key in shortcuts and instructions; KbdGroup for chords. - [Data grid](https://design-system.syncrobotic.me/docs/components/data-grid.md) (beta): A TanStack Table grid: sorting, pagination, selection, column menus, pinning, resizing, expandable rows, totals, loading, virtual rows. - [Timeline](https://design-system.syncrobotic.me/docs/components/timeline.md): Events in time order with neutral markers, status glyphs or icons; vertical, alternate or horizontal, grouped by day. - Pattern, Activity and audit timelines: [Robot activity](https://design-system.syncrobotic.me/blocks/timeline-activity.md): A robot's shift, newest first and grouped by day, each event with its kind as an icon. - Pattern, Activity and audit timelines: [Audit history](https://design-system.syncrobotic.me/blocks/timeline-audit.md): Who changed what, with the value before and after, filtered to people or the system. - [Trace](https://design-system.syncrobotic.me/docs/components/trace.md) (beta): The steps of a run with status and duration: missions, agent tool calls, rollouts, CI runs, audit trails. Steps open to show input, output or sub-steps; an optional waterfall bar. - [Marker](https://design-system.syncrobotic.me/docs/components/marker.md) (beta): A labelled line across a log or feed (a day, a takeover, an e-stop), and MarkerRow: one dense log line with a status glyph, detail and time. ## Components: Charts - [Chart](https://design-system.syncrobotic.me/docs/components/chart.md) (beta): Line, area and bar charts on Recharts, in graphite and one accent with series told apart by line style, with a crosshair tooltip, a legend and a table view. - Pattern, Line chart: [Telemetry over time](https://design-system.syncrobotic.me/blocks/line-chart-telemetry.md): Two series over time with a 1 h / 24 h switch and a table view: the default telemetry chart. - Pattern, Line chart: [Against a limit](https://design-system.syncrobotic.me/blocks/line-chart-limit.md): One measurement against its limit: the latest value up top, the limit as a labelled dashed line, a warning only while it is over. - Pattern, Line chart: [This period against the last](https://design-system.syncrobotic.me/blocks/line-chart-compare.md): This week against last week: the total and the change up top, the earlier period dashed. - Pattern, Area chart: [Battery over a shift](https://design-system.syncrobotic.me/blocks/area-chart-battery.md): One robot's battery over a shift with the return-to-dock level marked; the charge shows as the jump. - Pattern, Area chart: [Fleet by state](https://design-system.syncrobotic.me/blocks/area-chart-fleet-states.md): How the fleet splits between patrolling, charging and idle over the day: stacked step areas that add up to the fleet. - Pattern, Area chart: [Progress to a target](https://design-system.syncrobotic.me/blocks/area-chart-cumulative.md): The running total this month as an area against the plan as a dashed line, ahead or behind said in words. - Pattern, Bar chart: [Grouped by day](https://design-system.syncrobotic.me/blocks/bar-chart-missions.md): Two counts side by side per day, with totals and a table view. - Pattern, Bar chart: [Ranked categories](https://design-system.syncrobotic.me/blocks/bar-chart-ranked.md): Categories with long names, sorted, as horizontal bars with the value at each end. - Pattern, Bar chart: [Parts of a whole](https://design-system.syncrobotic.me/blocks/bar-chart-stacked.md): Stacked segments per category with a 2 px gap in the card colour. - Pattern, Bar chart: [Above and below plan](https://design-system.syncrobotic.me/blocks/bar-chart-variance.md): Positive and negative values in one hue around a drawn zero line, the biggest gap named. - Pattern, Sparkline: [Robot list with trend](https://design-system.syncrobotic.me/blocks/sparkline-robot-list.md): Each robot row with its last 12 hours of battery as a sparkline and the value now. - Pattern, Sparkline: [Metric tiles](https://design-system.syncrobotic.me/blocks/sparkline-metric-tiles.md): Three headline numbers, each with its week as a sparkline; only a change for the worse is coloured. - Pattern, Sparkline: [Table with a trend column](https://design-system.syncrobotic.me/blocks/sparkline-table.md): A table where each row's last 14 days are mini bars on one shared scale. - Pattern, Status tracker: [Uptime over 30 days](https://design-system.syncrobotic.me/blocks/status-tracker-uptime.md): One cell a day per robot: grey where it ran, colour only on degraded and down days, with a tooltip per day. - Pattern, Status tracker: [Run history](https://design-system.syncrobotic.me/blocks/status-tracker-runs.md): The last 20 runs of each route as a strip, newest on the right, with the pass count. - Pattern, Status tracker: [Rollout stages](https://design-system.syncrobotic.me/blocks/status-tracker-rollout.md): A rollout as stage lanes: finished stages checked, the running one in progress, later ones waiting. - Pattern, Radial chart: [Battery rings](https://design-system.syncrobotic.me/blocks/radial-chart-battery.md): Battery per robot as rings, neutral until low or critical, the number always in the middle. - Pattern, Radial chart: [Progress to a goal](https://design-system.syncrobotic.me/blocks/radial-chart-goal.md): One large ring with the share of the plan done and the breakdown beside it in words. - Pattern, Radial chart: [Capacity rings](https://design-system.syncrobotic.me/blocks/radial-chart-capacity.md): Several shares of capacity as concentric rings in series colours, each named with its value. - Pattern, Heatmap: [Time of week](https://design-system.syncrobotic.me/blocks/heatmap-week-hours.md): Days by 2-hour slots in one sequential hue, the busiest slot named, a tooltip per cell. - Pattern, Heatmap: [Zones by time of day](https://design-system.syncrobotic.me/blocks/heatmap-zones.md): Zones by time slots with the value written in every cell, so the colour only groups. - Pattern, Histogram: [Battery at docking](https://design-system.syncrobotic.me/blocks/histogram-battery.md): How one value is spread: battery level at docking in equal 5 % bins, the median as a labelled dashed line, bins under 15 % in warning, counts on hover and a table view. Exports binEqualWidth and median. - [Share bar](https://design-system.syncrobotic.me/docs/components/share-bar.md) (beta): How a whole splits, as one thin bar in the chart palette (the accent, two greys, Other): light enough for a table cell, with an optional label, total and legend. ## Components: Media & files - [Restricted preview](https://design-system.syncrobotic.me/docs/components/restricted-preview.md) (beta): A preview that is not loaded until someone asks: restricted data, or pictures with faces or number plates. Neutral, with the reason. - [Image grid](https://design-system.syncrobotic.me/docs/components/image-grid.md) (beta): Many pictures as a grid or a scroll-snap strip: lazy tiles that keep their aspect, skeleton, hidden and broken states, single or multiple picking, and a lightbox with arrow keys and Esc. - [Annotated image](https://design-system.syncrobotic.me/docs/components/annotated-image.md) (beta): Boxes, points, polygons and poses over a picture, in its own pixel space: predicted solid, ground truth dashed, the previous version dotted, each on a halo; class words, a line-style legend, selection by keyboard, raster overlays, loading and failed states. - [Media player](https://design-system.syncrobotic.me/docs/components/media-player.md) (beta): A recorded clip (a robot's camera recording, an incident clip) with the kit's controls over a native video: play, a timeline with event markers, time, mute, speed, captions and full screen on a scrim; keys while focused; loading, buffering and unavailable states. - [Attachment](https://design-system.syncrobotic.me/docs/components/attachment.md) (beta): One file in a list, a composer or a queue: type, name, size, progress, error with Retry, Download and Remove. - [File type](https://design-system.syncrobotic.me/docs/components/file-type.md) (beta): An icon for a file from its name or extension, with robot formats (mcap, bag, pgm, pcd, onnx) and the extension written on it. ## Components: Feedback - [Skeleton](https://design-system.syncrobotic.me/docs/components/skeleton.md) (beta): What is known shows first; only unknown values get a skeleton; the whole group breathes. - [Spinner](https://design-system.syncrobotic.me/docs/components/spinner.md): Appears only after 300 ms, so quick work never flashes a spinner. - [Progress](https://design-system.syncrobotic.me/docs/components/progress.md): Determinate progress; blue unless the value itself is a status. - [Banner](https://design-system.syncrobotic.me/docs/components/banner.md) (beta): A full-width notice at the top of the page or app about the app itself: maintenance, read-only mode, a trial ending, no connection. Tones, one action, optional dismiss. - [Alert](https://design-system.syncrobotic.me/docs/components/alert.md): Inline message in a status tone with icon, title and description. - [Alarm](https://design-system.syncrobotic.me/docs/components/alarm.md) (beta): ISA-18.2 alarms: three priorities with their own shape, colour and words, acknowledge and clear states, and a sorted list that announces new alarms to screen readers. - [Toast](https://design-system.syncrobotic.me/docs/components/toast.md) (beta): Transient feedback on what the user just did: 4 s, 8 s with an action, failures until dismissed. Call toast() anywhere; mount once. - [Empty state](https://design-system.syncrobotic.me/docs/components/empty-state.md): What is missing, why, and the one action that fixes it. - [Route progress](https://design-system.syncrobotic.me/docs/components/route-progress.md): A thin blue bar while the next page loads: shows after 300 ms, never reaches the end, gives up after 10 s. ## Components: Navigation - [Tabs](https://design-system.syncrobotic.me/docs/components/tabs.md): Sections of one page. - [Pagination](https://design-system.syncrobotic.me/docs/components/pagination.md): Range and previous / next, or numbered pages, for long lists. - [Breadcrumb](https://design-system.syncrobotic.me/docs/components/breadcrumb.md): Where this page sits: links to the levels above, the current page last. - [Accordion](https://design-system.syncrobotic.me/docs/components/accordion.md): Collapsible sections for settings and FAQs. - [Tree](https://design-system.syncrobotic.me/docs/components/tree.md) (beta): A hierarchy from data: a nested list with guide lines, disclosure buttons and links (list), or a tree widget with arrow keys, type-ahead and one selected node (select). - [Load more](https://design-system.syncrobotic.me/docs/components/load-more.md): The end of a long list on a phone or in a gallery: how much is shown, and one button for the next batch that says how many it adds and how many remain. - [Stepper](https://design-system.syncrobotic.me/docs/components/stepper.md) (beta): Where someone is in a fixed sequence of steps: done, current, upcoming and error steps, horizontal or vertical, with a compact bar for phones. - [Scrollspy](https://design-system.syncrobotic.me/docs/components/scrollspy.md) (beta): An On this page list that follows the reader through the sections of a page or a scroll area, and the useScrollspy hook behind it. - [Navigation menu](https://design-system.syncrobotic.me/docs/components/navigation-menu.md) (beta): A site's top navigation: links, and triggers that open panels of links and cards (Radix NavigationMenu). ## Components: Overlays - [Dialog](https://design-system.syncrobotic.me/docs/components/dialog.md) (beta): A short decision or form that needs an answer before you go on, in a panel over the page. - Pattern, Form and share dialogs: [Form in a dialog](https://design-system.syncrobotic.me/blocks/dialog-form.md): A short form in a dialog: three fields at most, errors under their fields, nothing typed is lost. - Pattern, Form and share dialogs: [Share dialog](https://design-system.syncrobotic.me/blocks/dialog-share.md): Invite people by email, change their access in place, and copy a link whose reach is said in words. - [Alert dialog](https://design-system.syncrobotic.me/docs/components/alert-dialog.md) (beta): Confirms an action that cannot be undone; the confirm names the consequence. - Pattern, Confirm a destructive action: [Confirm a deletion](https://design-system.syncrobotic.me/blocks/dialog-confirm-destructive.md): A dialog for something that cannot be undone: what is lost, who it affects, and the name typed to confirm. - [Sheet](https://design-system.syncrobotic.me/docs/components/sheet.md): A panel that slides in and floats 8 px from the screen's edges: a bottom sheet with a grab handle on phones, a side panel on wide screens, a drawer for navigation. - Pattern, Detail and filter sheets: [Robot detail panel](https://design-system.syncrobotic.me/blocks/sheet-robot-detail.md): One robot in a side panel over the list: state, levels, last events and actions in thumb reach. - Pattern, Detail and filter sheets: [Filters sheet](https://design-system.syncrobotic.me/blocks/sheet-filters.md): Filters in a bottom sheet: grouped options with counts and one button that says how many results you will see. - [Popover](https://design-system.syncrobotic.me/docs/components/popover.md) (beta): Extra detail anchored to a control. - [Hover card](https://design-system.syncrobotic.me/docs/components/hover-card.md) (beta): A preview of what a link leads to, on hover and keyboard focus. Preview only: never the only way to the facts or actions in it. - [Tooltip](https://design-system.syncrobotic.me/docs/components/tooltip.md) (beta): Names an icon-only control on hover and focus. - [Dropdown menu](https://design-system.syncrobotic.me/docs/components/dropdown-menu.md): Actions on an item; destructive actions last. - [Context menu](https://design-system.syncrobotic.me/docs/components/context-menu.md) (beta): Actions on an item by right-click or long press, styled exactly like the dropdown menu; a shortcut to actions that are also on a visible control. - [Command](https://design-system.syncrobotic.me/docs/components/command.md): Search and run from the keyboard: a filterable list, and the ⌘K palette that opens over any page. ## Components: Layout - [Card](https://design-system.syncrobotic.me/docs/components/card.md): One surface with radius 16 for a group of related content. - [Separator](https://design-system.syncrobotic.me/docs/components/separator.md): Horizontal or vertical hairline. - [Scroll area](https://design-system.syncrobotic.me/docs/components/scroll-area.md): A bounded region with a thin themed scrollbar, vertical, horizontal or both, with optional fading edges. - [Page header](https://design-system.syncrobotic.me/docs/components/page-header.md) (beta): The block a page opens with: breadcrumb above, one h1 and a line, meta pills, actions at the right. No label above the title. - [Resizable](https://design-system.syncrobotic.me/docs/components/resizable.md) (beta): Panels resized by dragging the line between them or with the arrow keys, horizontal, vertical or nested (react-resizable-panels). ## Components: Hooks & libraries - [ROS](https://design-system.syncrobotic.me/docs/components/ros.md) (beta): ROS and ROS 2 over rosbridge with no ROS library: a rosbridge v2 client on the browser's WebSocket (ref-counted subscriptions and advertisements, capped jittered reconnect that resubscribes, a send queue, service calls with a timeout, a zero Twist when a velocity publisher stops or the link drops) and pure converters from OccupancyGrid, LaserScan, PointCloud2, JointState and poses to the kit's components, and from a teleop command and a map goal back to Twist and PoseStamped. - [useLongPress](https://design-system.syncrobotic.me/docs/components/use-long-press.md) (beta): Press and hold with progress from 0 to 1. - [useSlideRelease](https://design-system.syncrobotic.me/docs/components/use-slide-release.md) (beta): Drag, threshold and spring-back logic for slide to release. - [usePresence](https://design-system.syncrobotic.me/docs/components/use-presence.md): Keeps an element, or list items, on screen while they leave, so exits use the disappear movement instead of vanishing. - [useDebounce](https://design-system.syncrobotic.me/docs/components/use-debounce.md) (beta): A value, or a function call, that waits until changes pause: a search sent when the typing stops, not on every key. - [useRos](https://design-system.syncrobotic.me/docs/components/use-ros.md) (beta): React hooks over the ros client: RosProvider, useRosStatus, useRosTopic (the latest message, through useSyncExternalStore), useRosPublisher (a stable publish function; a zero Twist on unmount, hidden page and dropped link for cmd_vel) and useRosService (a call with a timeout). - [useHotkeys](https://design-system.syncrobotic.me/docs/components/use-hotkeys.md) (beta): Keyboard shortcuts as a map of keys to handlers ({ "1": yes, "mod+z": undo, "?": help }), quiet while someone types in a field, with the key being pressed for Kbd. ## More - [Full catalog](https://design-system.syncrobotic.me/llms-full.txt): every item with its when to use and agent notes, and the design language. - [Repository](https://github.com/Syncrobotic/SyncAI-Lib-DesignSystem)