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.