Skip to main content
@gentleduck/cli

Add components from your terminal

Scaffold a project and copy gentleduck/ui components into it. Five commands: init, add, update, diff, and list.

Get startedView source

  • init

    Detects your framework, writes duck-ui.config.json, sets up Tailwind, and installs the base dependencies.

  • add

    Installs components by name. It resolves dependencies, writes the source into your project, and follows your tsconfig aliases.

  • update

    Pulls the latest registry source into components you already have. No hand-editing 50 files to stay current.

  • diff

    Compares your local copy with the registry, so you can review upstream changes before you run update.

  • list

    Browses the registry from your terminal, with categories, names, and current versions in one view.

  • Monorepos

    Pass --monorepo to init and --workspace apps/web to every other command. Each workspace gets its own setup.

Install

Works with Next.js, Vite, Remix, and Astro.

  1. Set up your project

    npx @gentleduck/cli init

  2. Add components

    npx @gentleduck/cli add button

Free & open source

gentleduck is MIT licensed and will always be free and open source. Every package ships with full source access — fork it, modify it, own it.

Become a Sponsor