PHPackages                             jiordiviera/php-ui - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. jiordiviera/php-ui

ActiveLibrary[CLI &amp; Console](/categories/cli)

jiordiviera/php-ui
==================

A shadcn-like CLI for Laravel Livewire components.

042PHPCI passing

Since Dec 22Pushed 4mo agoCompare

[ Source](https://github.com/jiordiviera/php-ui)[ Packagist](https://packagist.org/packages/jiordiviera/php-ui)[ RSS](/packages/jiordiviera-php-ui/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

PHP-UI
======

[](#php-ui)

[![Tests](https://github.com/jiordiviera/php-ui/actions/workflows/tests.yml/badge.svg)](https://github.com/jiordiviera/php-ui/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/a64fe1974c2dc5de5730a80c254c92cb03b3fb0164ce4f00682cd670b97f9c00/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a696f72646976696572612f7068702d75692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jiordiviera/php-ui)[![Total Downloads](https://camo.githubusercontent.com/9ddad991c7d42773e8c64ec89c295bc8105dc9eb10e8f1b991380722e3fa33a0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a696f72646976696572612f7068702d75692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jiordiviera/php-ui)[![License](https://camo.githubusercontent.com/fdc1259685be987132b938789b59acd666630f1c441521278e2e2de5fd1fb799/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a696f72646976696572612f7068702d75692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jiordiviera/php-ui)

**A shadcn-like CLI for Laravel Livewire components.**

PHP-UI allows you to scaffold beautifully designed, accessible, and customizable components for your Laravel Livewire applications. It detects your Tailwind setup (v3 or v4) and handles dependencies automatically.

Installation
------------

[](#installation)

You can install the package via composer globally to use it in any project:

```
composer global require jiordiviera/php-ui
```

Alternatively, you can install it as a dev dependency in a specific project:

```
composer require --dev jiordiviera/php-ui
```

Usage
-----

[](#usage)

### 1. Initialize

[](#1-initialize)

Run the init command to set up the configuration for your project.

```
php-ui init
```

### 2. List Available Components

[](#2-list-available-components)

See all components you can add to your project.

```
php-ui list
```

### 3. Add Components

[](#3-add-components)

Use the `add` command to scaffold a new component.

```
php-ui add
```

**Options:**

- `--force` or `-f`: Overwrite existing files without asking.
- `--url` or `-u`: Install a component from a direct URL.
- `--registry` or `-r`: Use a custom registry URL.
- `--repo`: Install from a GitHub repository.

### 4. Install from Remote Sources

[](#4-install-from-remote-sources)

PHP-UI supports installing components from remote sources, similar to shadcn/ui.

**From a direct URL:**

```
php-ui add --url https://example.com/my-button.blade.php.stub
```

**From a GitHub repository:**

```
php-ui add button --repo owner/repo
php-ui add button --repo owner/repo@branch
```

**From a custom registry:**

```
php-ui add button --registry https://example.com/registry.json
php-ui add --registry https://example.com/registry.json  # Interactive search
```

Available Components (25+)
--------------------------

[](#available-components-25)

### Base &amp; Form

[](#base--form)

- `button`: Versatile button with variants and sizes.
- `input`: Form field with label, icons, and error handling.
- `toggle`: Accessible switch for boolean values.
- `range-slider`: Single or double handle numeric slider.
- `file-upload`: Zone with drag-and-drop and progress bar.

### Navigation &amp; Layout

[](#navigation--layout)

- `breadcrumbs`: Navigation trail for nested pages.
- `tabs`: Tabbed interface for content switching.
- `modal`: Accessible dialog with transitions.
- `drawer`: Side panel sliding from edges.
- `accordion`: Expandable content panels.

### Feedback &amp; Status

[](#feedback--status)

- `alert`: Contextual messages for user actions.
- `badge`: Small status indicators.
- `toast`: Global notification system.
- `tooltip`: Hover information popups.
- `progress-bar`: Visual progress indicator.
- `progress-steps`: Horizontal process tracker.
- `skeleton`: Loading state placeholders.

### Data &amp; Visualization

[](#data--visualization)

- `data-table`: Advanced table with search, sort, and pagination.
- `stat-card`: Metrics display with trends and icons.
- `timeline`: Chronological event display.
- `rating`: Star rating with half-star support.

### Utilities

[](#utilities)

- `avatar`: Profile image with fallback initials and status.
- `avatar-group`: Stacked user avatars.
- `command-palette`: Global Spotlight-style search interface.
- `kbd`: Keyboard key indicators.
- `code-snippet`: Code display with copy functionality.
- `empty-state`: Placeholder for empty collections.

Creating a Custom Registry
--------------------------

[](#creating-a-custom-registry)

You can host your own component registry. Create a `registry.json` file:

```
{
  "name": "My Custom Components",
  "baseUrl": "https://raw.githubusercontent.com/username/my-components/main",
  "components": {
    "custom-button": {
      "description": "My custom button component",
      "dependencies": {
        "composer": ["mallardduck/blade-lucide-icons"],
        "npm": []
      },
      "css_vars": {},
      "js_stubs": []
    }
  }
}
```

Then host your stubs in a `stubs/` folder alongside the registry.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance52

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity18

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/809a4ada50fc54fe02b1956bc85fbf9e403f3a8de208faf27dc5fd19b84d4035?d=identicon)[jiordiviera](/maintainers/jiordiviera)

---

Top Contributors

[![jiordiviera](https://avatars.githubusercontent.com/u/157500676?v=4)](https://github.com/jiordiviera "jiordiviera (81 commits)")

### Embed Badge

![Health badge](/badges/jiordiviera-php-ui/health.svg)

```
[![Health](https://phpackages.com/badges/jiordiviera-php-ui/health.svg)](https://phpackages.com/packages/jiordiviera-php-ui)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.0k17.2M320](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M19](/packages/consolidation-annotated-command)[chi-teck/drupal-code-generator

Drupal code generator

26947.8M5](/packages/chi-teck-drupal-code-generator)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
