README

Druid Starter Kit

A modern, opinionated starter kit for Laravel 12+ applications with Vue 3, TypeScript, and Tailwind CSS.

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
• 🌐 Laravel Dusk - Browser testing for Laravel
• ⚡️ 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

# Run tests
composer test

# Run tests with coverage
composer test:coverage

# Run browser tests (Laravel Dusk)
composer test:browser

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

# Run static analysis
composer analyse

# Format code
bun run format

# Lint code
bun run lint

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.

Test coverage generation