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