# blatui
**Category:** π Data Visualization
**Repository:** https://github.com/anousss007/blatui
**Views:** 0
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/blatui
## Description
shadcn/ui for Laravel Blade β discover, read and install BlatUI components, blocks and charts.
## Claude Desktop Quick Installation
Heuristic fallback β verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):
```json
"mcpServers": {
"blatui": {
"command": "npx",
"args": ["-y","blatui"]
}
}
```
## Documentation & README
# BlatUI
### shadcn/ui for the **BLAT** stack β **B**lade Β· **L**aravel Β· **A**lpine Β· **T**ailwind
A CLI that copies open-source, copy-paste UI components **you own** straight into your Laravel project.
[](https://packagist.org/packages/anousss007/blatui)
[](https://github.com/anousss007/blatui/actions/workflows/ci.yml)
[](LICENSE)
[](https://blatui.remix-it.com)
**155 components Β· 614 variants Β· 64 blocks Β· 70 charts Β· accessible (WCAG AA) Β· Livewire-ready Β· fully themeable Β· light + dark Β· MIT**
[Live demo & docs β blatui.remix-it.com](https://blatui.remix-it.com)
> 𧩠**This is the BlatUI monorepo.** The Composer package is the repo **root** (`src/` + `stubs/`)
> β Packagist reads it directly, so `composer require anousss007/blatui` is unchanged and the
> `apps/` are stripped from the dist tarball. Components are **authored in `apps/demo/`** and
> generated into `stubs/`. See [Contributing](#contributing) before editing a component.
---
## Why BlatUI
- **Accessible by default.** WAI-ARIA roles, complete keyboard navigation & focus management, and WCAG AA color contrast β modeled on shadcn/ui's Base UI behavior, verified in a real browser and audited with axe-core. Accessibility isn't an add-on; it ships in every component.
- **You own the code.** Components are *copied* into your project β not hidden in `vendor/`. Edit them however you like; updating the package never overwrites your edits.
- **The BLAT stack.** Pure Blade components, a sprinkle of Alpine.js for interactivity, Tailwind CSS v4 for styling. No React, no build-step lock-in.
- **Livewire-ready.** `wire:model` works on every form control β inputs, selects, checkboxes, switches, sliders, date/time pickers, file uploads and more β with full two-way binding. A free, you-own-the-code alternative to Flux Pro. [See the Livewire guide β](https://blatui.remix-it.com/docs/livewire)
- **Faithful to shadcn/ui.** Same design language, component APIs and blocks β ported to the Laravel way.
- **Themeable to the core.** Every token is a CSS variable.
## Requirements
- PHP 8.2+ Β· Laravel 11, 12 or 13
- Tailwind CSS v4 Β· Alpine.js 3 Β· Node 18+
## Installation
```bash
# 1. Install the CLI
composer require anousss007/blatui
# 2. Peer packages used by the components
composer require gehrisandro/tailwind-merge-laravel mallardduck/blade-lucide-icons
npm install -D alpinejs @alpinejs/anchor @floating-ui/dom @alpinejs/collapse @alpinejs/focus
# 3. Publish the foundations (theme tokens + Alpine/chart/calendar engine)
php artisan vendor:publish --tag=blatui-foundations
# β resources/css/blatui.css (oklch design tokens, presets, light/dark)
# β resources/js/blatui.js (greenfield bootstrap β boots Alpine for you)
# β resources/js/blatui-core.js (engine: registerBlatUI, for apps already running Alpine)
# 4. Verify your setup
php artisan blatui:init
```
Point your two Vite entrypoints at the published foundations β **replace** each file's contents:
```css
/* resources/css/app.css */
@import "./blatui.css";
```
```js
// resources/js/app.js
import "./blatui.js";
```
> `blatui.css` brings Tailwind, the design tokens and the `@theme`
> mapping; `blatui.js` boots Alpine + its plugins and lazy-loads ApexCharts. Run
> `blatui:init` to confirm everything (packages, tokens, imports) is wired up.
> The foundations are published once and become *yours* β tweak the tokens, drop
> the chart engine if you don't need charts, etc. `blatui:init` will tell you
> what's still missing.
### Installing into an existing project
Everything is **additive** β you don't replace your files.
- **Tailwind v4 is required.** BlatUI uses v4-only features (`@theme inline`, oklch). On
Tailwind v3, migrate first with `npx @tailwindcss/upgrade`; `blatui:init` detects the version.
- **CSS:** add `@import "./blatui.css";` to your existing `app.css`, below `@import "tailwindcss";`.
- **JS β already running Alpine?** Don't import `blatui.js` (it would boot a second Alpine).
Register BlatUI into your own instance instead, before you start it:
```js
import Alpine from 'alpinejs'
import { registerBlatUI } from './blatui-core.js'
registerBlatUI(Alpine) // plugins + theme store + chart/calendar engines
window.Alpine = Alpine
Alpine.start()
```
- **JS β using Livewire or Flux?** Livewire bundles and starts Alpine for you, so don't
`npm install alpinejs` (that's the duplicate-Alpine trap) and don't import `blatui.js`.
Install only the plugins β `npm install -D @alpinejs/anchor @floating-ui/dom @alpinejs/collapse @alpinejs/focus`
(add `apexcharts` only if you use charts) β and register BlatUI onto Livewire's Alpine via
the `alpine:init` hook:
```js
import { registerBlatUI } from './blatui-core.js'
document.addEventListener('alpine:init', () => {
registerBlatUI(window.Alpine)
})
```
BlatUI registers a `theme` store for dark mode. If Flux already drives dark mode, pass
`registerBlatUI(window.Alpine, { darkMode: false })` so the two don't both toggle `.dark`.
## Adding components
```bash
# Add one or more β dependencies are resolved automatically
php artisan blatui:add button card input
# See everything you can add β components, blocks & charts
php artisan blatui:list
# Details for a single component
php artisan blatui:list select
# Everything at once
php artisan blatui:add --all
```
Components land in `resources/views/components/ui/` as Blade tags:
```blade
Welcome back
Sign in to continue.
Sign in
```
`blatui:add` prints any extra `composer`/`npm` packages a component needs
(e.g. charts pull in `apexcharts`).
## Keeping components up to date
You own the copied files, so an upgrade is never automatic β `blatui:update`
shows you what changed and lets you decide, file by file:
```bash
# What would change across everything you have installed?
php artisan blatui:update --dry-run --diff
# Update, confirming each file that differs from the version we ship
php artisan blatui:update
# Just these families, no questions asked (your version is kept as .bak)
php artisan blatui:update button card --force
```
A file that differs is either your customisation or an outdated copy β nothing on
disk tells the two apart, so BlatUI never overwrites one without showing the diff
and asking. `--force` still writes a `.bak` next to each file it replaces (opt out
with `--no-backup`). Files a family gained in a newer release are simply added.
Running Pint or Prettier over `resources/views`? Your formatter rewrites the
layout of every component you copied, and all of them then read as changed. They
are counted separately as *same content, reformatted*, and `--ignore-whitespace`
leaves them out:
```bash
php artisan blatui:update --dry-run --ignore-whitespace
```
The CSS/JS foundations are published, not copied β re-sync those with
`vendor:publish --tag=blatui-foundations --force`; `blatui:init` tells you when
the engine has fallen behind.
## Blocks & charts
Blocks (dashboards, sidebars, login pagesβ¦) and the 70 charts are **copy-paste
from the demo site** β they're full-page compositions, not primitives, so you
grab the exact source you want rather than installing it:
π **[Browse blocks & charts on the live demo](https://blatui.remix-it.com/blocks)**
## Commands
| Command | Description |
|---|---|
| `blatui:init` | Doctor β checks packages, Tailwind v4, theme tokens, Alpine/engine wiring |
| `blatui:list [component]` | List all component families, or detail one |
| `blatui:add ` | Copy components (+ deps) into your project |
| `blatui:update [components...]` | Diff installed components against this version and update them (`--dry-run`, `--diff`, `--force`, `--ignore-whitespace`) |
| `blatui:doctor [path]` | Scan your Blade for known footguns (typeless buttons in forms, leaked tags) |
| `blatui:mcp` | Run the MCP server (stdio) so an AI editor can search and install components |
| `vendor:publish --tag=blatui-foundations` | Publish theme CSS + JS engine |
## Contributing
BlatUI is a **monorepo** β one repo, one PR, one CI. The Composer package is the repo root;
the demo/docs site and starter kit are apps that live alongside it (excluded from the published
package via `.gitattributes`).
```
composer.json src/ stubs/ β the published package (this is what `composer require` gets)
apps/demo/ β authors AND renders every component; the live docs site
apps/starter/ β the Laravel starter kit
scripts/build-package.sh β regenerates stubs/ from apps/demo (CI enforces it)
```
Components are **authored in `apps/demo/resources/views/components/ui/`** (the only place they
render, so it's the source of truth); `stubs/` is generated β don't hand-edit it. After changing
a component, run `bash scripts/build-package.sh` and commit both. CI fails if they drift.
Full guide: [CONTRIBUTING.md](CONTRIBUTING.md).
## Credits
BlatUI is a port of [**shadcn/ui**](https://ui.shadcn.com) to the Laravel/Blade
ecosystem. Thanks to [shadcn](https://twitter.com/shadcn) and contributors.
Icons by [Lucide](https://lucide.dev). Charts by [ApexCharts](https://apexcharts.com).
## License
[MIT](./LICENSE) β free for personal and commercial use.