CLI

Coming soon — the CLI isn't available yet, but here's what it will do.

The PersianLabs/ui CLI will scaffold a ready-to-run starter project so you don't wire anything up by hand. Instead of copy-pasting individual components one by one, one command generates a full app — Turborepo or plain Next.js — with the pieces you actually need.

What it will generate

• A Turborepo workspace or a plain Next.js app, your choice
• A selection of the PersianLabs/ui components you need, installed and wired
• The Vazir font installed by default with the recommended Persian-first stack
• Everything pre-configured: shadcn-ready registry, theming tokens, RTL (dir="rtl"), and the digit/date primitives — so your first render already looks like PersianLabs/ui.

Shape of the command (subject to change)

npx @persianlabs/cli@latest create my-app

You'll be asked which starter (Turborepo or Next.js), which components to include, and whether to use TypeScript. When it ships, this page will be updated with the full usage and options.

Why start with a starter

PersianLabs/ui is copy-paste, but a few things are worth pre-configuring once — RTL, the Vazir font, the registry, and the theming tokens. A generator means every new project gets those right without re-reading Installation, Theming, RTL, and Fonts each time.

Follow the repo for the release announcement.