PHPackages                             vrcorp/laravel-neo-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. [Utility &amp; Helpers](/categories/utility)
4. /
5. vrcorp/laravel-neo-ui

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

vrcorp/laravel-neo-ui
=====================

Neo Brutalism UI for Laravel based on TailwindCSS

501JavaScriptCI passing

Since Jul 14Pushed 1mo agoCompare

[ Source](https://github.com/vrcorp/laravel-neo-ui)[ Packagist](https://packagist.org/packages/vrcorp/laravel-neo-ui)[ RSS](/packages/vrcorp-laravel-neo-ui/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

 Laravel Neo UI
================

[](#--laravel-neo-ui)

 **A brutally beautiful, Tailwind CSS based UI component library for Laravel.**
 Bring the bold, high-contrast, and unapologetic aesthetics of Neo Brutalism to your Laravel applications.

 [Installation](#installation) • [Configuration](#configuration) • [Components](#components) • [Documentation](#documentation)

---

⚡ Introduction
--------------

[](#-introduction)

**Neo Brutalism UI** is a lightweight, zero-dependency (other than Tailwind) UI library designed to give your application an edgy, modern **Neo Brutalism** design instantly.

This package provides two ways to use it:

1. **A Tailwind CSS Plugin** (`neo-brutalism-tailwind`) that injects beautiful brutalist utility classes (`.btn`, `.card`, `.input`, etc.). This can be used in **ANY project** (HTML, PHP, Vue, React, etc.).
2. **A Laravel Blade Component Library** (`vr/laravel-neo-ui`) for seamless integration specifically in Laravel views (``).

✨ Features
----------

[](#-features)

- **Framework Agnostic (CSS)**: The Tailwind plugin works anywhere you use Tailwind.
- **Zero CSS to Write**: Everything is handled by the Tailwind plugin.
- **100% Tailwind Compatible**: Mix and match with standard Tailwind utilities.
- **Dynamic Prefixing**: Don't want to pollute your global CSS classes? Prefix everything with `neo-` via a simple config file.
- **13+ Premium Components**: Buttons, Modals, Toasts, Avatars, Data Tables, Tabs, Accordions, and Full Forms.

---

📦 Installation
--------------

[](#-installation)

### 1. Install Tailwind CSS Plugin (NPM) - *For All Projects*

[](#1-install-tailwind-css-plugin-npm---for-all-projects)

Install the Tailwind plugin via NPM:

```
npm install neo-brutalism-tailwind
```

#### Method A: Tailwind CSS v4 (New Standard)

[](#method-a-tailwind-css-v4-new-standard)

If you are using the new Tailwind v4, you don't need a `tailwind.config.js` file. Simply import the plugin in your main CSS file (e.g., `input.css` or `app.css`):

```
@import "tailwindcss";
@plugin "neo-brutalism-tailwind";
```

#### Method B: Tailwind CSS v3 (Legacy / Typical Laravel)

[](#method-b-tailwind-css-v3-legacy--typical-laravel)

If you are using Tailwind v3, open your `tailwind.config.js` and add the plugin:

```
module.exports = {
    content: [
        "./*.html", // If using pure HTML
        "./resources/**/*.blade.php", // If using Laravel
        "./vendor/vr/laravel-neo-ui/resources/views/**/*.blade.php",
    ],
    theme: {
        extend: {},
    },
    plugins: [
        require('neo-brutalism-tailwind')({
            prefix: '' // Optional: e.g., 'neo-' if you want your classes to be .neo-btn
        })
    ],
}
```

### 2. Install Laravel Package (Composer) - *Optional, for Laravel only*

[](#2-install-laravel-package-composer---optional-for-laravel-only)

Require the package via Composer to get the Blade components:

```
composer require vr/laravel-neo-ui
```

---

⚙️ Configuration (Laravel Only)
-------------------------------

[](#️-configuration-laravel-only)

By default, the Blade components will output un-prefixed classes (e.g., `class="btn"`). If you set a prefix in your `tailwind.config.js` (e.g., `prefix: 'neo-'`), you **must** tell the Laravel package to use the same prefix.

Publish the config file:

```
php artisan vendor:publish --tag=neo-ui-config
```

Then edit `config/neo-ui.php`:

```
return [
    'prefix' => 'neo-', // If you use 'neo-' in tailwind config
];
```

---

🚀 Usage
-------

[](#-usage)

You can use the native HTML class syntax anywhere, or use the Blade components if you are in Laravel.

### Native HTML / PHP Usage:

[](#native-html--php-usage)

```
Submit Data

    Username

```

### Laravel Blade Usage:

[](#laravel-blade-usage)

```
Submit Data

    Username

    This is an alert box!

```

### 🎨 Built-in Icons (Lucide)

[](#-built-in-icons-lucide)

Neo UI comes bundled with **Lucide Icons** out of the box via the `mallardduck/blade-lucide-icons` package.

You can use the icons directly inside components using the `icon` attribute, or use the icon component separately:

```

     Home

```

### Alpine.js Integration (Modals &amp; Toasts)

[](#alpinejs-integration-modals--toasts)

For interactive elements like Modals, Tabs, and Toasts, we recommend including [Alpine.js](https://alpinejs.dev/):

```

    Save

```

---

📚 Documentation &amp; Examples
------------------------------

[](#-documentation--examples)

For a full list of components, interactive live demos, copy-pasteable HTML snippets, and advanced usage, please visit our Official Documentation:

👉 **[Laravel Neo UI Official Documentation](https://vrcorp.github.io/laravel-neo-ui/)**

### Standalone Sample Project

[](#standalone-sample-project)

We have also included a fully working, standalone example in the `sample/` directory of the repository. It uses the real NPM package and Tailwind CSS build process. To test it out locally:

1. Clone the repository and navigate to the `sample` folder.
2. Run `npm install` to install Tailwind CSS and the Neo Brutalism plugin.
3. Run `npm run build` to compile the CSS.
4. Open `index.html` in your browser.

---

📜 License
---------

[](#-license)

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

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance60

Regular maintenance activity

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity11

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/f6d723f2787a1aacacde744633f45d1d1e5962056604ea49658e666a4f9e57a8?d=identicon)[vrcorp](/maintainers/vrcorp)

---

Top Contributors

[![vrcorp](https://avatars.githubusercontent.com/u/68215251?v=4)](https://github.com/vrcorp "vrcorp (9 commits)")

### Embed Badge

![Health badge](/badges/vrcorp-laravel-neo-ui/health.svg)

```
[![Health](https://phpackages.com/badges/vrcorp-laravel-neo-ui/health.svg)](https://phpackages.com/packages/vrcorp-laravel-neo-ui)
```

###  Alternatives

[kx1000/kwota-slownie

Kwota słownie

1019.9k1](/packages/kx1000-kwota-slownie)

PHPackages © 2026

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