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.

Druid includes all Laravel Jetstream and Fortify features - Teams, API tokens, profile management, two-factor authentication, browser sessions, password reset, email verification, and more - rebuilt from the ground up with Vue 3, TypeScript, and 100% test coverage.

Features

Core Stack

🚀 Laravel 12 - Latest Laravel with PHP 8.4+ support
⚡️ Vue 3 with Vite and SSR support
🧩 Shadcn-Vue - Beautiful, accessible UI components
🔧 TypeScript - Full type safety across the stack
🎨 Tailwind 4 with dark mode support
📱 Inertia.js - Modern SPAs without API complexity

Authentication & Security (Fortify + Jetstream Features)

🔐 Two-Factor Authentication - TOTP-based 2FA with recovery codes
🔑 API Token Management - Personal access tokens with granular permissions
👥 Team Management - Create teams, invite members, assign roles
📧 Team Invitations - Email-based invitations with signed URLs
🖼️ Profile Photos - User avatar uploads with automatic storage
📋 Browser Sessions - View and logout other active sessions
🗑️ Account Deletion - Self-service deletion with confirmation
📜 Terms & Privacy Policy - Legal document pages with agreement tracking
🔒 Password Reset - Secure email-based password recovery
✉️ Email Verification - Verified email enforcement
🔄 Password Confirmation - Sensitive action protection
🛡️ Laravel Fortify - Backend authentication scaffolding
🔒 Laravel Sanctum - Cookie and token-based API auth

Developer Experience

🧪 Pest PHP - Elegant testing with 100% code coverage
⚡️ Vitest - Lightning-fast JavaScript unit testing
🔍 Larastan - Static analysis at max level
📝 ESLint + Prettier - Consistent code style
🔄 Automated semantic releases with conventional commits
👷 GitHub Actions CI/CD with parallel testing
💯 100% code coverage with automated badge reporting

Feature Configuration

All Jetstream-equivalent features are configurable in config/teams.php:

'features' => [
    Features::termsAndPrivacyPolicy(),  // Terms of Service & Privacy Policy pages
    Features::profilePhotos(),           // User profile photo uploads
    Features::api(),                     // API token management
    Features::teams(['invitations' => true]),  // Teams with email invitations
    Features::accountDeletion(),         // Self-service account deletion
],

Simply remove any feature from the array to disable it. The UI automatically adapts to show only enabled features.

Requirements

PHP 8.4 or higher
Composer 2+
Node.js 24+ (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
composer dev

# Build for production
bun run build

# Format code
composer lint

# Run PHP static, type, and feature tests
composer test

# Run JavaScript tests --currently 89% coverage
bun run test

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.

druidweb / druid

Maintainers

Details