Introduction

PersianLabs/ui is a copy-paste component library built RTL-first for Persian interfaces, on top of shadcn/ui and Base UI. There's no package to install and no runtime to depend on — every component is distributed as source through a shadcn registry, and lands directly in your codebase when you run the CLI.

There's no separate installation

This library is built entirely on top of shadcn/ui, so it doesn't ship its own setup flow. If your project already has shadcn configured, skip straight to adding components. If it doesn't, initialize it once with the standard shadcn CLI — nothing about that step is specific to this registry.

From there, add any component by name. The CLI resolves it from the @persianlabsui registry, copies the source straight into your project, and wires up its dependencies automatically.

Why copy-paste

Components are yours once they land — no version to chase, no black-box dependency to patch around. Every component is plain React and Tailwind, built on Base UI primitives, and ready to be read, extended, or rewritten to fit your product.