Repository navigation
Releases
v0.27.0
Connect the robotics components to a real robot over rosbridge, and a ready-made Traditional Chinese (Taiwan) label pack.
Added
rosanduse-ros0.27.0 (beta): a rosbridge v2 connection over a plain WebSocket, with no ROS library.RosProvider,useRosStatus,useRosTopic,useRosPublisheranduseRosService, plus converters from each message to the component that shows it:occupancyGridToGridandlaserScanToScan(robot-map),pointCloud2ToPoints(point-cloud),jointStateToJoints(joint-state, robot-model),poseToRobotMapPose,goalToPoseStampedandteleopToTwist(teleop-pad). A publisher ofTwistsends a zero command when it stops. New page Connect to ROS with the rosbridge setup for ROS 2 and ROS 1, a live example against a simulated bridge, and the safety notes for driving over a browser: rosbridge has no watchdog, so the robot must time out its own commands.labels-zh-tw0.27.0 (beta): the kit's words in Traditional Chinese as written in Taiwan, one object per component that takeslabels(dataGridLabels,stopButtonLabels,robotMapLabels…), andlocale. It imports no component, so it installs on its own; the kit's tests hold every object to the component's labels type, so a new key cannot ship untranslated. See Localisation.
Fixed
time-picker0.23.3: a malformed value ("9", "25:99") reads as no time instead of showing NaN; a malformedmin,maxorstepfalls back to its default.text-diff0.16.2: text of spacing alone round-trips throughtokenizeexactly and is never shown as a word added or removed.robot-model0.24.2: mimic joints follow their driving joint unclamped and whatever the order of the record; planar and floating joints take[x, y, θ]and[x, y, z, roll, pitch, yaw]and are written with the newposeValuelabel (mm and degrees per component).alarm0.27.0: buttons beside Acknowledge (a custom action, Shelve) are ghost, so Acknowledge is the only outlined button in an unacknowledged row; Unshelve, alone in its row, keeps its outline.toast0.27.0: toasts stack as in sonner: the newest in front, two more peeking behind, the rest waiting; hovering, focusing or touching spreads them into a list and pauses their timers. A 4th toast no longer makes the others jump or closes the oldest, and a second<Toaster />no longer draws every toast twice (which let a hovered toast close anyway).banner0.27.0: opens and closes its height as it fades, so the page under it slides instead of jumping when it is dismissed or shown again.treeandtrace0.27.0: an empty folder (or a span with nothing under it) opens and closes in place; it opened as tall as its parent before snapping shut, because Radix leaves its height variable unset at 0.- Docs: component pages are short again; the long Table 9 upgrade section on the data-grid page is gone. Banner and tree examples keep their width when they collapse, so they no longer jump sideways.
- Storybook: the story frame no longer overflows a 390 px phone.
- CI type-checks its own scripts (
tsconfig.scripts.json, strictcheckJs).
v0.26.0
data-grid moves to TanStack Table 9. The grid looks and behaves the same; the table you build for it changes, once.
Changed
data-grid0.26.0 needs@tanstack/react-table9. You still own the table: build it withuseTable({ features, … }), wherefeaturesstarts from the exporteddataGridFeatures(every feature and sort function the grid's parts call) plus the row models you use. Column types take the features (DataGridColumnDef<Row, typeof features>), pinning isstart/end, andtable.getState()is gone. The data-grid page has the full guide: Upgrading to TanStack Table 9, with before-and-after code, a prompt to hand a coding agent, and a grep checklist that must print nothing when you are done.- React Compiler:
data-grid.tsxstarts with"use no memo". Table 9 keeps one row, column and header object for the table's life and answers state through methods, which compiled code would cache. Keep the directive in your copy. CalluseTablewithout a selector, and in your own cells read state through<Subscribe source={row.table.atoms.…}>. A test now compiles the grid with the React Compiler and checks that sorting, selection, expanding and resizing update; without the directive it fails. - Dependabot no longer holds
@tanstack/react-tablemajors;react-resizable-panels4 stays held.
v0.25.0
Dependencies move to current majors where products gain from it or lose nothing; two are held on purpose.
Changed
calendaranddate-selector0.25.0 needreact-day-picker10 (npm i react-day-picker@^10, then re-install both). DatePicker and DateRangePicker take the same props and render the same calendar. Calendar passes its props to DayPicker, so props v10 removed stop type-checking:fromMonth/fromYear/toMonth/toYearbecomestartMonth/endMonth;fromDate/toDatebecomestartMonth/endMonthwithhidden={{ before }}/{{ after }};initialFocusbecomesautoFocus; v8-style classNames keys and theonDayPointer*/onDayTouch*handlers are gone; non-Gregorian calendars come from@daypicker/*. Locales can be imported per language (react-day-picker/locale/zh-TW); the combined import still works.form0.25.0 names@hookform/resolvers@^7(it named no range before, so recent installs already had 7). Its zod resolver is unchanged and works with zod 3.25+ and zod 4.- The repo develops against
lucide-react1.x, as products installing items already do (items name lucide with no range). Kit code keeps its icon names, which lucide 1.x still exports, so no item changed and no minimum lucide version is needed. lucide 1.x redrew some icons (CreditCard, Rocket, Plug, Warehouse and others) and hides icons with no label from screen readers by default (aria-hidden).
Fixed
data-grid0.23.3: a column's resize handle is named after the column ("Resize Robot"); screen readers heard the header function's source code. New behaviour tests for paging, sorting, visibility, selection, expanding, pinning, resizing, totals, loading and empty.
Held
@tanstack/react-table9 andreact-resizable-panels4 are not adopted yet. Table 9 makes every product rewrite its table setup for no visible gain; Panels 4 halves the keyboard resize step and resets saved layouts. Both migrations are done and kept for when a product needs them or the old majors stop getting fixes; Dependabot ignores their majors until then.
v0.24.2
Fixed
- Autofilled fields keep the theme. A field the browser filled in (a saved search, an address) turned light blue in Chrome, also in dark mode, and inside a search field or input group the blue box sat inside the field's edge. The theme now delays the browser's fill for good and keeps the text in the theme's colour, so a filled field looks like any other. Re-install
syncrobotic-theme. - The page tells the browser its colour scheme:
color-scheme: light, anddarkinside.dark. Native parts (scrollbars, date and time pickers, autofill) now follow the theme instead of staying light on a dark page. - Docs: the Code block examples are highlighted the way a product does it, with shiki's output as
children(they showed plain text, so the component looked uncoloured).
v0.24.1
Fixes from an independent review of 0.23.1 and 0.24.0, new behaviour tests, and a sweep of every docs page; the dev tooling moves to current majors.
Fixed
robot-map0.24.1: a grid that arrives after the first render is fitted (a view the person moved is left alone); a cancelled drag (second finger, pointer cancel, Esc) puts a waypoint or zone corner back and says so; the selected or carried waypoint is followed by value, so Delete never removes another one when the app changes the list; a fast-updating costmap always shows its latest finished image; the costmap draws over a floorplan; the keyboard crosshair and a carried point announce their position once the keys rest; snapping at the plan edge, the crosshair before the first key, and a goal set twice by pointer and Enter.joint-state0.24.1: numbers format in English unlesslocaleis given, so the server and the browser agree (an invalid tag falls back instead of throwing); an update is detected by value, so a parent that rebuilds the array still goes stale (passupdatedAtso a still arm is not called stale);staleAfterMs={Infinity}never goes stale; an infinite limit is no limit.point-cloud0.24.1: an inlinecolorRangeno longer re-uploads the cloud on every parent render; no black frame on resize; the accessible name stays stable (the count and extent are in a description updated at most every 5 s); Windows forced colours keep the cloud visible; a lost pointer capture ends the drag; live scans reuse one buffer.robot-model0.24.1: staleness follows joint values orupdatedAt, not object identity, and is announced once; a lost WebGL context that does not come back within 5 s shows an error with Load again instead of an endless "Restoring"; an empty URDF is an error; meshes arriving after a change are freed; mesh paths with a query string load; theme changes on an ancestor repaint.segmented-control0.17.3: pressing the selected segment no longer clears the choice.file-upload0.10.1: withmultipleoff, extra files are refused ascountinstead of dropped silently;aria-labeland other attributes reach the drop zone.timeline0.17.4: a warning or danger event says so to screen readers.- Docs: no sideways scroll on phones from long property defaults or identifiers; no 2 px scrollbars on data-grid examples and a code block.
Changed (repository)
- Storybook 8.6 → 10.6, Vitest 3 → 5, Vite 6 → 8 (story ids unchanged);
@vitejs/plugin-react, unused, removed. - Behaviour tests for
timeline,file-upload,scrollspyandsegmented-control. - Dependabot: weekly grouped minor and patch updates and monthly GitHub Actions updates, as pull requests into
dev.
v0.24.0
Robot components for what an operator sees and does: a LiDAR point cloud, a 3D robot model, joint states, and a robot map that takes ROS grids and scans and can be edited. Every item now compiles under noUncheckedIndexedAccess.
Added
point-cloud(beta): a LiDAR or depth cloud (a decodedsensor_msgs/PointCloud2, REP 103 axes) in raw WebGL2, with no 3D library. Coloured by height or intensity on the accent's single hue with its scale in words, never a rainbow; a recessive ground grid, the robot at the origin, an axes gizmo in words. Orbit, pan and zoom by pointer, touch and keyboard (the wheel only once focused), Reset view and Fit at 44 px. Loading, empty, error, stale (staleAfterMs,receivedAt) and no-WebGL states; context loss handled; draws only on demand.robot-model(beta): a robot's pose in 3D from its URDF (urdforurdfUrl,package://throughpackages) and live joint values (joints, orjointStateToRecordfrom asensor_msgs/JointState). Neutral greys from the theme, joints that need someone highlighted in warning or danger with a callout in words. The kit's only three.js item:threeandurdf-loaderinstall with it alone; load it lazily (on the docs site only its own page downloads three.js). Without WebGL it lists every joint in words.joint-state(beta): an arm's joints for monitoring: position in degrees or millimetres on a thin track between its limits, velocity and effort; near a limit (5 % by default), at it or past it said in words with an icon; stale afterstaleAfterMsby the browser's clock. Stacks by its own width.robot-map0.24.0: ROS layers and editing.griddraws anav_msgs/OccupancyGridas the floor (free the map surface, occupied a muted grey at its probability, unknown the no-data hatch); with nowidth/heightthe grid is the plan.costmaplays the accent's ramp over it with a legend.scansdrawssensor_msgs/LaserScans from each robot's pose, one path per scan.mode(goal,waypoints,zone): place and point a goal, add, move and delete numbered waypoints, draw zones corner by corner (editableZonesdrags existing corners); controlled, with optionalsnap. The primary pointer edits; right or middle drag and two fingers pan. A keyboard crosshair with Enter, Esc and Delete does the same, a banner says what a click does, and each edit is announced.- Helpers
gridToPlan,rosToPlan,rasteriseGrid,scanToPoints.
- Docs: Robotics UI kit (Getting started): the robot components by what an operator does, and the ROS message each one takes.
- Docs sidebar: a quiet Beta after each beta item.
Fixed
- Every item compiles with
noUncheckedIndexedAccess, checked in CI (tsconfig.registry.json). Behaviour unchanged, except three crashes on an empty list:AppShellMobileTabswith no tabs,AppShellsearch with no scopes, a pagedQuestionnairewith no questions. Re-install the items whose version moved in this release (each one's changelog line says why). robot-map: zone names keep clear of the mode banner and legend, as robot names do.
Changed
- Site title, description and keywords say what the kit is (a robotics UI kit for React), for search.
v0.23.1
Engineering: every item now passes the React Compiler's rules and compiles with noUnusedLocals and noImplicitReturns. No API changed.
Fixed
- Safe under the React Compiler. A product that builds with
reactCompiler: truecompiles the kit's source with its own; components that read or wrote refs while rendering, set state synchronously in an effect, or calledDate.now()during render were skipped or could misbehave. Fixed with React's own patterns, behaviour unchanged except that a reset on a new prop now lands in the same render instead of one commit later (no stale frame):- state kept from the previous render instead of a ref:
field,choice-field(a fixed error fades out),island,image-grid(the lightbox's last picture),data-grid(the selection count while it leaves); - a reset when a prop changes, during render:
autocomplete,time-picker,media-player,route-progress,notification-center,camera-feed,use-presence; useSyncExternalStorefor browser-only facts:app-shell(Mac or not),list-detail(the first robot selected on wide screens);- latest values in a layout effect or
useEffectEvent:teleop-pad,robot-map,camera-feed;use-debouncekeeps its timer in a closure;use-long-pressdeclares its loop where it is used;input-group,tree(type-ahead times by the key event),graph,filters,attachment. data-grid's virtualiser (TanStack Virtual) is a library the compiler cannot optimise; it is left uncompiled on purpose, with the reason in the source.
- state kept from the previous render instead of a ref:
- Compiles with
noUnusedLocalsandnoImplicitReturns: no unused React import inagent-trace,card-mission,card-site,heatmap-zones,radial-chart-capacity,robot-status-card,sheet-robot-detail,sparkline-robot-list,sparkline-table,stats-cards,stats-meters,status-tracker-rollout,status-tracker-runs,form,status-glyph,load-more,meter,share-bar,theme-toggle;settings-webhooksreturns explicitly.
Re-install the items above (npx shadcn add @syncrobotic/<item> --overwrite); the version in each file's header says whether you have it.
Changed (repository)
- ESLint (TypeScript recommended, React hooks with the compiler rules) runs in CI as
npm run lint. - TypeScript:
noUnusedLocals,noUnusedParameters,noImplicitReturns,noFallthroughCasesInSwitch,noImplicitOverride; nobaseUrl(deprecated in TypeScript 6). - Docs site security headers:
frame-ancestors 'self',X-Frame-Options,nosniff,Referrer-Policy,Permissions-Policy(fullscreen and the clipboard stay allowed). - visual-baseline starts
cion the commit it pushes, so a release no longer waits on a check that never runs. - Node 22 pinned (
.nvmrc,engines). /brand: the product-photos placeholder is gone; no photos are planned.
v0.23.0
What robot products need that no other kit has (a live camera, a dead-man drive pad, a site map), and every component's words translatable.
Added
camera-feed(beta): a robot's live camera over a native<video>the app feeds (a WebRTCstream, set assrcObject, or asrcthe browser plays), no streaming library; the app owns the connection. It always says whether the picture is live, by a shape and a word in the header beside the camera and the robot: Live (a still dot, never red, never pulsing) withlatencyMs; Connecting (the only blue: a spinner, over a skeleton that holdsaspectRatio); Stalled · last frame 14:02:31 over the dimmed last picture afterstaleAfterMs(2 s) without a new frame, watched withrequestVideoFrameCallback, elsetimeupdate; Paused; Camera offline withofflineReasonand Reconnect (onRetry); No camera. Pause view freezes this screen only (the robot keeps streaming); snapshot draws the frame on screen to a PNG foronSnapshot; mute only withaudio; full screen. Space and F only while focus is inside.childrenare drawn over the picture (a crosshair, detection boxes). Labels exported asCameraFeedLabels/defaultCameraFeedLabels, withformatTimefor the site's clock.- Icon set:
VideoOff, for no live picture (the camera is offline, or there is none). teleop-pad(beta): manual driving of a mobile robot from a phone or a console, as a dead-man stick. The robot moves only while the stick is held: release, a cancelled pointer, lost focus, a hidden page ortimeoutMswithout pointer events send a zero command at once and callonStopwith the reason. While held,{ linear, angular }(−1…1, ROS REP 103 axes) goes out at a fixedrateHz(10) so the robot can run its own watchdog. Pressing never moves the robot (the stick starts where the finger lands); dead zone 10 %,maxSpeeddrawn as a scale; arrow keys or W A S D while held, Space to stop; a status line with icon and words (Hold to drive, Driving · 0.4 m/s, Stopped, Disabled: reason); 56 px knob, larger in glove density; haptic ticks. A mouse held perfectly still sends no events, so the 2 s pointer timeout stops it too;timeoutMs={false}turns that off, only where the robot runs its own watchdog. The emergency stop stays StopButton, beside it.feedback:driveStartanddriveStoppatterns (one and two short ticks) for manual driving.- Icons
Move(moving under manual driving) andCirclePause(standing still after manual driving ended). robot-map0.23.0 (beta): the kit's site map, as a component. It lived only as a drawing insidemap-workspace.RobotMapdraws a floor plan in metres (an image URL or your SVG) in plain SVG, with no map library: zones (no entry, slow, charging, other) as hairline outlines with an icon and a name, never a fill; planned routes dashed in the in-progress blue, travelled tracks solid grey; robots as their status shape with a heading tick and their name, which moves aside rather than cover another, and the state in words when a robot needs someone; selection as a ring and a bold name. Pan and zoom by drag, two fingers, the wheel (once the map has focus, or with Ctrl, so a page still scrolls past it), 44 px zoom and fit buttons, and keys (arrows, + / -, 0), gliding at--motion-baseunless motion is reduced. A scale bar, a north arrow whennorthDegis given, and empty, loading and error states. The map is one Tab stop;RobotMapListlists the same robots with position, zone, heading and state, and a row selects its robot on the map. Coordinates are metres from the plan's top-left, y down, heading clockwise from the top; from a ROS map frame:x = xRos − originX,y = height − (yRos − originY),heading = 90 − yaw × 180 / π(in the docs and the type).lint:rules: a block that draws aRobotMapmust also renderRobotMapList, as a chart block renders its table and a graph block its list.
Changed
map-workspace0.23.0 is built onrobot-map: same layout, trays and markers, now with heading ticks, a named loading bay, a scale bar and pan and zoom. Its robots are listed in a Robots sheet from the top bar.- Localisation: every word the kit says can be translated without editing its source. Components that showed or announced fixed English now take
labels, the kit's existing pattern: an exported<Name>Labelstype and Englishdefault<Name>Labels, merged under a partiallabelsprop, with functions for words that hold a number or a name. New in 0.23.0: Autocomplete, Breadcrumb, ChipGroup, CommandDialog, CopyButton, DataGrid (every part,selectColumnandexpandColumnincluded; DataGridPagination passes Pagination's), DatePicker and DateRangePicker, DialogContent, PhoneInput, Questionnaire and QuestionField, RouteProgress, SearchField, Spinner, Attachment, Stepper and StepperCompact, Sortable (its drag announcements), Trace and TraceHeader (status words, counts, durations), TimePicker. The defaults are today's words; single props such aslabel,placeholderandcloseLabelstill work and win. localewhere a component formats a number, a day or a time itself: ChipGroup, Filters, LoadMore and ShareBar (numbers; left out, the browser's language as before), DatePicker and DateRangePicker (the trigger's day with Intl, pluscalendarLocalefor react-day-picker's calendar), TimePicker (times with Intl), PhoneInput (country names and their order; English when left out). Calendar lets a react-day-picker locale such aszhTWname its days.- Docs: Localisation (Getting started): why labels and locale, the pattern, a worked zh-TW example, and every component's keys with their English defaults, generated from the source (
npm run propsnow records each labels prop's keys in site/props.json).
Fixed
tabs0.23.0: no scrollbar on the tab list on phones. The triggers sit 1 px past the list's border (-mb-px, so the underline covers it); withoverflow-x: autofor many tabs,overflow-ycomputes to auto too, so the list scrolled 1 px vertically and Android showed a scrollbar on first load.overflow-yis now hidden (also on the docs' component tabs and the drawer's area tabs). Checked on all 334 pages at phone width: no box scrolls by 1–4 px any more.
v0.22.4
Docs site only: no item changed, nothing to re-install.
Fixed
- The docs sidebar flashed on every page switch. The current-page marker slid with a shared layout animation while the previous page's examples closed with a height animation above it; the column re-scrolled every frame to keep the clicked link still, and the marker, measured against the moving column, swept down the list as a grey box before settling. The marker is now static, the examples list appears and goes at once, and the column scrolls back in the same frame by however far the clicked link moved (Safari has no scroll anchoring). Recorded: 15 changing frames per switch before, 3 after.
- Phones: picking a page in the navigation drawer showed the old page through the drawer, then the new one over it. The page transition is a view transition, whose snapshots paint above everything, the open drawer included. A navigation from the drawer now skips it: the tapped link is marked at once, the drawer stays until the new page is there, then slides away from it. The drawer's click handler also runs in the capture phase now; next/link prevents the default in its own handler, so the 0.22.3 handler never ran.
Changed
- Block pages on phones. "Built from" takes its own line, with the chips under it, so no chip wraps to sit under the label. Below 640 px the preview shows the phone view only: the device-width switch is hidden (a desktop layout would be drawn at a quarter of its size), Open shares the row with Preview and Code, and the block fills the card with no second frame, stage padding or width caption.
v0.22.3
Docs site only, on phones: no item changed, nothing to re-install.
Fixed
- Phones: the page jumped when you picked a page in the navigation drawer. The drawer's list followed the address, and the drawer only began to close once the next page had arrived. So while it faded out, its list rearranged itself under your finger: the current-page marker slid to the new item, the old page's examples folded, the new page's unfolded, and the column re-scrolled to centre it. Now the drawer starts closing on the tap and its list stays as it was when you opened it; the next time it opens, it shows where you are. Measured on an iPhone 13 viewport: layout shifts during the switch went from 8 to 0.
Changed
- Phones: the navigation drawer, redesigned. The area switcher was a 2×2 block of buttons with the current one solid black (white in dark), the loudest thing in the drawer; a large "Navigation" title and a lone "Home" row took the top; the open page's examples unfolded inside the drawer and pushed the other pages away; and on the home page the drawer was nearly empty. Now the drawer starts with the logo (the way home, as in the header), the four areas are one quiet row of tabs with an underline, like a component page's tabs, the examples stay on the page, and on the home page the four areas are the list.