README

A modern Laravel 12 starter kit powered by Blade, Tailwind CSS v4, Vite, Pest, and full-stack automation for clean, maintainable development—now including Basecoat UI out-of-the-box.

🎥 Live Preview

🖥️ Dashboard

🔐 Multiple Login Screens

1. Card

2. Split

🚀 Features

• Laravel 12 with PHP 8.4
• Blade + Alpine.js for reactive UIs
• Tailwind CSS v4 + Prettier integration
• Basecoat UI — Tailwind-powered component library (shadcn/ui style, but no React required)
• Vite for fast frontend builds
• Pest for testing with 100 % type & coverage targets
• Pint, Peck, Rector, Larastan for code quality
• Full dev script with auto-serve, queue, logs, and Vite in sync

🛠 Installation

git clone <your-repo>
cd <project>
composer install
npm ci
npm run build
cp .env.example .env
php artisan key:generate
php artisan migrate

💻 Local Development

composer dev

This runs:

• php artisan serve
• php artisan queue:listen
• php artisan pail (for logs)
• npm run dev (Vite + Tailwind)

All in parallel using concurrently.

✅ Testing & QA

composer test

Runs:

• ✅ Type coverage via Pest
• ✅ Unit tests with 100% coverage requirement
• ✅ Typo checking via Peck
• ✅ PHP formatting check via Pint
• ✅ JS formatting check via Prettier
• ✅ Static analysis with PHPStan
• ✅ Dry-run refactor with Rector

💅 Code Style

PHP

composer lint        # Auto-fix with Pint + Prettier
composer test:lint   # Lint check only (no changes)

Frontend

npm run lint         # Auto-fix Prettier (resources/)
npm run test:lint    # Check only

🧩 Project Structure

├── resources/
│   ├── css/            # Tailwind + Basecoat UI + Custom components.
│   ├── js/             # Alpine.js stores/components + Basecoat UI components + Custom components.
│   └── views/          # Blade templates
├── routes/web.php      # App routes
├── tests/              # Pest tests
├── app/Actions/        # Action-based logic
├── peck.json           # Peck spelling config

📦 Included Packages

Backend (via composer.json)

• Laravel 12
• Pest — Modern PHP testing framework with Laravel integration
• PHPStan — Static analysis for catching bugs early
• Peck — Detects spelling/typos in codebase
• Pint — Laravel's official code style fixer
• Rector — Refactoring and PHP version upgrade assistant
• Larastan — PHPStan support for Laravel-specific logic
• Pail — Local Laravel log viewer in terminal
• Faker, Mockery — Test data and mocking

Frontend (via package.json)

• Tailwind CSS v4
• Basecoat UI — Tailwind-powered component library (shadcn/ui style, but no React required)
• Prettier with:
  • prettier-plugin-tailwindcss
  • prettier-plugin-organize-imports
• Alpine.js — Lightweight JavaScript interactivity
• Axios — Promise-based HTTP client
• Vite — Fast JS/CSS bundling
• Concurrently — Run dev scripts in parallel

🧪 CI Integration

Designed to work seamlessly with GitHub Actions:

composer test # Used in CI to validate full code quality

🤝Contributing

1. Fork & clone
2. composer install && npm ci && npm run build
3. Create a feature branch (git checkout -b feat/my-change)
4. Run composer test → all green
5. PR with a clear description 🎉

📄 License

MIT — Free to use and modify.