rrpadilla/laravel-starter-kit

Laravel Blade + Tailwind Starter Kit.

Installs: 0

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 0

Forks: 0

Open Issues: 0

Language:Blade

Type:project

v1.0.3 2025-07-01 00:39 UTC

This package is auto-updated.

Last update: 2025-07-01 00:41:08 UTC


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

Dashboard Preview

πŸ” Multiple Login Screens

1. Card

login-card

2. Split

login-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.