README

DN Laravel Starter Kit

DN Laravel Starter Kit is a Laravel application template designed to streamline the development process for new projects. It includes a pre-configured authentication system, Inertia.js/React frontend integration, Tailwind CSS with a modern design system, shadcn UI components library, optimized development environment setup, predefined testing configuration, and essential Laravel packages.

🚀 Features

• Authentication system ready out-of-the-box
• Inertia.js/React frontend integration
• Tailwind CSS with modern design system
• shadcn UI components library
• Optimized development environment setup
• Predefined testing configuration
• Actions pattern for better code organization and testability
• Laravel Dump Server for improved debugging (documentation)
• Laravel Wayfinder for simplified routing (documentation)
• Includes essential Laravel packages

📐 Actions Pattern

This starter kit implements the Actions pattern, which helps organize business logic into single-purpose, reusable classes. Each Action class is responsible for executing a specific task, making the code more maintainable, testable, and following the Single Responsibility Principle.

Actions are located in the app/Http/Actions directory and are organized by domain (e.g., Account, Auth). Controllers delegate business logic to these Action classes, keeping controllers thin and focused on HTTP concerns.

Example usage in a controller:

public function index(Request $request) {
    return Inertia::render("account/account",[
        'currentUser' => new UserResource(
            $this->getAccountAction->execute(Auth::id())
        )
    ]);
}

🛠️ Installation

1. Create project and navigate:

laravel new --using=nelsondiego/dn-laravel
cd your-project-name

Important: This application requires running with SSL (using Herd or Valet) due to history encryption. See the Inertia.js documentation for more details.

1. Start development server:

php artisan serve

👨💻 Contribuciones bienvenidas | 📄 Licencia MIT | 🐛 Reportar issues