druidweb/druid

A modern, opinionated starter kit for Laravel 12+ applications

v1.2.2 2025-06-25 04:46 UTC

Requires

• php: ^8.3
• inertiajs/inertia-laravel: ^2.0.2
• laravel/framework: ^12.9.0
• laravel/sanctum: ^4.0.8
• laravel/tinker: ^2.10.1
• predis/predis: ^3.0.1
• pusher/pusher-php-server: ^7.2.7
• tightenco/ziggy: ^2.5.2
• zenphp/modulr: ^1.0

Requires (Dev)

• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.4
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.8.0
• pestphp/pest: ^3.8.1
• pestphp/pest-plugin-laravel: ^3.1.0
• zenphp/fixr: ^1.0.3

MIT

• framework
• laravel
• starter-kit

README

Druid Starter Kit

The most comprehensive and battle-tested Laravel + Vue starter kit available. Built with modern best practices, complete testing coverage, and production-ready tooling to accelerate your development from day one. Features cutting-edge technologies like Laravel 12, Vue 3 with TypeScript, Tailwind 4, and a complete CI/CD pipeline with automated testing and deployment.

Unlike other starter kits that give you a basic setup and leave you to figure out the rest, Druid provides a complete development ecosystem. Every component is tested, every workflow is automated, and every decision has been made with scalability and maintainability in mind. From comprehensive testing with Pest and Vitest to automated semantic releases, this isn't just a starter kit, it's a complete foundation for building production applications that can grow with your business.

Features

• 🚀 Laravel 12 - Latest Laravel with PHP 8.3+ support
• ⚡️ Vue 3 with Vite
• 🧩 Shadcn-Vue - Beautiful, accessible, and responsive UI components
• 🔧 TypeScript - Full type safety
• 🎨 Tailwind 4 with dark mode support
• 📱 Inertia.js - Modern single-page apps without API complexity
• 🔒 Laravel Sanctum - API authentication
• 🧪 Pest PHP - Testing with pleasure
• ⚡️ Vitest - Fast JavaScript unit testing
• 🔍 Larastan - Static analysis for Laravel
• 📝 ESLint + Prettier - Consistent code style
• 🔄 Automated releases with semantic-release
• 👷 GitHub Actions workflows for testing and deployment
• 🏗️ Pre-configured development environment
• 💯 100% code coverage with automated reporting

Requirements

• PHP 8.3 or higher
• Composer 2+
• Node.js 18+ (preferably Bun)
• SQLite / MySQL / PostgreSQL

Installation

First, ensure you have the Laravel installer v5.14+ installed globally:

composer global require laravel/installer

Then create a new Laravel application using this starter kit:

laravel new --using=druidweb/druid

For more information about Laravel starter kits, please refer to the Laravel documentation.

Development

# Update all dependencies
bun run cb

# Start development server
bun run dev

# Build for production
bun run build

# Format code
bun run format

# Lint code
bun run lint

# Run JavaScript tests (Vitest)
bun run test:js

# Run tests
composer test

# Run tests with coverage
composer test:coverage

# Run static analysis
composer analyse

Maintenance Branches

This starter kit follows semantic versioning using maintenance branches:

• main - Latest development version
• N.x - Maintenance branches for major versions (e.g., 1.x, 2.x)

Contributing

Please see CONTRIBUTING.md for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

License

The MIT License (MIT). Please see License File for more information.