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
Requires
- php: ^8.4
- blade-ui-kit/blade-icons: ^1.8
- laravel/framework: ^12.19.3
- laravel/tinker: ^2.10.1
- mallardduck/blade-lucide-icons: ^1.23.0
Requires (Dev)
- barryvdh/laravel-debugbar: ^3.15.4
- fakerphp/faker: ^1.24.1
- larastan/larastan: ^3.5.0
- laravel/pail: ^1.2.3
- laravel/pint: ^1.22.1
- mockery/mockery: ^1.6.12
- nunomaduro/collision: ^8.8.2
- peckphp/peck: ^0.1.3
- pestphp/pest: ^3.8.2
- pestphp/pest-plugin-laravel: ^3.2.0
- pestphp/pest-plugin-type-coverage: ^3.5.1
- rector/rector: ^2.1.0
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
- Fork & clone
composer install && npm ci && npm run build
- Create a feature branch (
git checkout -b feat/my-change
) - Run
composer test
β all green - PR with a clear description π
π License
MIT β Free to use and modify.