README

🚀 Quick Application Bootstrapping

Tired of adding the same configuration code to every new Laravel project? This package automatically applies best practice configurations and installs essential development tools with a single command.

✨ Features

• 🔄 Automatically applies common Laravel configurations
• 🧰 Installs essential dev tools (Debugbar, Larastan, Rector)
• 📝 Creates pre-configured tool settings files
• 🛠️ Provides helpful artisan commands
• ⚡ Optimizes DB access with destructive command protection
• 📅 Configures Carbon for immutable dates
• 🔍 Sets up strict model usage with automatic eager loading
• 🌐 Enforces HTTPS in production
• 🚀 Configures Vite with aggressive prefetching

📋 Requirements

• PHP 8.3+
• Laravel 12+

📦 Installation

composer require marekmiklusek/laraboost

🔧 Usage

Automatic Configuration

Once installed, the package will automatically apply all configurations:

• DB destructive command protection in production
• Carbon immutable dates
• Strict model usage with automatic eager loading
• HTTPS enforcement in production
• Vite with aggressive prefetching

Installing Development Tools

Run the following command to install development tools:

php artisan install:dev-tools

This command will install the following packages via Composer:

• Laravel Debugbar
• Larastan (PHPStan for Laravel)
• Rector (PHP refactoring tool)

It will also create the following configuration files in your project root:

• pint.json - Laravel Pint configuration
• phpstan.neon - Larastan configuration
• rector.php - Rector configuration

Creating Action Classes

Generate new action classes using the provided Artisan command:

php artisan make:action CreateTodoAction

This will create a new action class with the following structure:

<?php

declare(strict_types=1);

namespace App\Actions;

use Illuminate\Support\Facades\DB;

final readonly class CreateTodoAction
{
    /**
     * Execute the action.
     */
    public function execute(): void
    {
        DB::transaction(function (): void {
            //
        });
    }
}

💻 Configuration Details

Applied Configurations

// Database commands
DB::prohibitDestructiveCommands(app()->isProduction());

// Date handling
Date::use(CarbonImmutable::class);

// Model configurations
Model::automaticallyEagerLoadRelationships();
Model::unguard();
Model::shouldBeStrict();

// URL handling
URL::forceHttps(app()->isProduction());

// Vite configuration
Vite::useAggressivePrefetching();

🧪 Development Tools

Laravel Debugbar

A package that adds a debugging bar at the bottom of your pages during development, providing valuable information about queries, views, routes, and more.

Larastan

A PHPStan wrapper for Laravel that provides static analysis for your Laravel application code.

Rector

A tool for automated refactoring and upgrades of your PHP code.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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