README

BlatUI Starter

A Laravel app pre-wired with BlatUI — shadcn/ui for the BLAT stack.

Spin up a BlatUI-powered app in one command:

laravel new my-app --using=blatui/starter

What's inside

• Laravel 13 · Tailwind CSS v4 · Alpine.js 3 · Vite.
• The full BlatUI component set copied into resources/views/components/ui/ (81 components · 416 variants · 283 files) — you own every line.
• Foundations wired: resources/css/app.css → @import './blatui.css', resources/js/app.js → import './blatui.js' (boots Alpine + the BlatUI engine: components, charts, calendar).
• Pre-built pages:
  • / — marketing landing (resources/views/landing.blade.php)
  • /dashboard — analytics dashboard with sidebar + charts
  • /login, /register — auth screens
• Theme tokens are CSS variables — recolor everything from the BlatUI theme editor and paste into app.css.

Run it

cp .env.example .env
php artisan key:generate
php artisan migrate
npm install && npm run build   # or: npm run dev
php artisan serve

Add more components

php artisan blatui:add <component>     # e.g. command, date-picker, sonner
php artisan blatui:list                # browse everything

Add real auth

The auth screens are UI only. For working authentication, layer Laravel's auth on top and keep the BlatUI forms:

composer require laravel/breeze --dev
php artisan breeze:install blade