CLI

Add and update components from the terminal. The Aidash CLI writes source files directly into your project so you can freely modify them — no black-box package.

Copy over install
The CLI is optional. Every component listed on this site can be copy-pasted directly. The CLI just saves you a few clicks and keeps you on the latest source.

init

Bootstrap a new or existing project. Runs an interactive setup that writes the design tokens into your global stylesheet and creates the components alias.

Terminal
bash
pnpm dlx @aidash/cli init
Output
bash
? Which framework are you using? › Next.js (App Router)
? Which style would you like to use? › Default
? Which colour do you want to use as the base? › Aidash Blue
? Where is your global CSS file? › app/globals.css
? Configure the import alias for components? › @/components

Writing globals.css …
Installing dependencies …
Done. Run "pnpm dev" to start.
Info
The init command is idempotent — running it twice reuses your answers and only rewrites files if the source template has changed.

add

Pull a component's source into your project. Files land under the alias you configured during init (default: @/components/aidash).

Add a single component

Give the component name — the CLI writes the source, installs any missing peers, and prints the import path.

Terminal
bash
pnpm dlx @aidash/cli add button
Output
bash
✓ Fetched button
✓ Wrote src/components/aidash/button.tsx
✓ Installed peer dependencies

Import with:
 import { AidashButton } from "@/components/aidash/button"

Add multiple at once

Space-separated names. Handy when scaffolding a new screen.

Terminal
bash
pnpm dlx @aidash/cli add button card dialog input select

Answer prompts up-front

Skip the interactive prompts by passing flags. Useful in CI/CD.

Terminal
bash
pnpm dlx @aidash/cli add button --yes --overwrite

diff

Compare the version you have locally against the latest upstream source. Shows what changed since you copied it.

Terminal
bash
pnpm dlx @aidash/cli diff button
Note
Because you own the source, diff never overwrites anything. It just prints a coloured patch so you can pick which changes to keep.

update

Apply upstream changes to all installed components at once. The CLI asks before touching each file.

Terminal
bash
pnpm dlx @aidash/cli update

Configuration

The CLI persists your answers to components.json so future commands work without prompting.

components.json
json
{
  "$schema": "https://aidash.dev/schema.json",
  "style": "default",
  "tailwind": {
    "css": "app/globals.css",
    "baseColor": "brand"
  },
  "aliases": {
    "components": "@/components"
  }
}
No tailwind.config
Tailwind CSS v4 is configured entirely in CSS, so there is no tailwind.config entry — the CLI only needs to know which stylesheet holds your @theme block. See Configuration.

Also see

Related pages that pair well with the CLI.

Manual installationConfiguration reference