Skip to content
Design System
GitHub

Installation

Components install as source code into your project, the same way shadcn/ui does. You can read and change every line.

1. Prerequisites

A React or Next.js project that has run npx shadcn init with Tailwind CSS v4.

2. Add the registry

In components.json. No token is needed.

components.json
{
  "registries": {
    "@syncrobotic": {
      "url": "https://design-system.syncrobotic.me/r/{name}.json"
    }
  }
}

3. Install the theme

bash
npx shadcn add @syncrobotic/syncrobotic-theme

Import it after Tailwind in globals.css, then delete the :root, .dark and @theme inline blocks that shadcn init generated.

globals.css
@import "tailwindcss";
@import "../styles/syncrobotic-theme.css";

Light is the default: it reads in daylight and glare. For a control room or a night shift, put class="dark" on <html>.

4. Add components

bash
npx shadcn add @syncrobotic/dock @syncrobotic/stop-button @syncrobotic/slide-to-release @syncrobotic/island

5. Localise

Default copy is English. Every visible and screen-reader string can be replaced through props, e.g. <StopButton labels={{ ready: "Parada de emergencia" }} />.

Notes

  • Installing two or more components that share @syncrobotic/cn prints “Circular dependency detected”. The CLI is merging shared dependencies; the result is correct.
  • The shadcn CLI fetches base colours from ui.shadcn.com during install, so the machine needs access to it.