CLI Commands
A complete reference for every command exposed by the @pphatdev/registry CLI.
You can run the CLI via global installation (pphat) or directly via npx. The following invocations are equivalent:
npx pphat <command>npx pphatdev <command>npx pphatdev <command>init
Interactively initializes project preferences and generates a pphatdev.json file in the project root.
npx pphat initPrompts will guide you through selecting resource types (icons, components), formats (SVG, Next.js, Nuxt.js), and storage paths.
config
View and update configuration settings interactively or programmatically.
Interactive Configuration
npx pphat configGet Configuration
npx pphat config getnpx pphat config get icons.nextjs.dirSet Configuration
npx pphat config set icons.nextjs.use truelist / ls
Lists available icons or components in the registry with interactive page-by-page browsing.
npx pphat list iconsnpx pphat ls componentsadd-icon / add
Downloads one or multiple icons from the registry into your project.
npx pphat add-icon react vue githubOptions
| Flag | Long Flag | Description |
| --- | --- | --- |
| -f | --format <fmt> | Specify output format (svg, nextjs, nuxtjs) |
| -d | --dir <path> | Specify destination directory |
Examples
npx pphat add-icon react vue -d src/assets/iconsnpx pphat add-icon github -f nextjsadd-component / add-comp
Downloads one or multiple UI components from the registry.
npx pphat add-component button card modalOptions
| Flag | Long Flag | Description |
| --- | --- | --- |
| -f | --format <fmt> | Specify output format (nextjs, nuxtjs) |
| -d | --dir <path> | Specify destination directory |
Examples
npx pphat add-component button -f nextjs -d src/components/ui