README

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

Features

🚀 Laravel 12+ - Latest Laravel with PHP 8.2+ support
⚡️ Vue 3 with Vite
🔧 TypeScript - Full type safety
🎨 Tailwind CSS with dark mode support
📱 Inertia.js - Modern single-page apps without API complexity
🔒 Laravel Sanctum - API authentication
🧪 Pest PHP - Testing with pleasure
📝 ESLint + Prettier - Consistent code style
🔄 Automated releases with semantic-release
👷 GitHub Actions workflows for testing and deployment
🏗️ Pre-configured development environment

Requirements

PHP 8.2 or higher
Composer 2+
Node.js 18+ (or 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 cn

# Start development server
bun run dev

# Build for production
bun run build

# Run tests
php artisan test

# 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

If you discover any security-related issues, please email hello@druidweb.com instead of using the issue tracker.

License

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

druidweb / druid

Maintainers

Details