README

Laravel Base Pack is a Laravel package that provides a basic structure for managing:

• Commands with dedicated handlers
• Events and listeners
• Repositories with interfaces and implementations

It's designed to be integrated into an existing Laravel application, standardizing conventions and promoting code organization.

📦 Installation

Install the package via Composer:

composer require alangiacomin/laravel-base-pack

After installing the package, you must run the following Artisan command to complete the setup:

php artisan basepack:install

This command will publish the configuration and perform the necessary setup for the package to work correctly in your Laravel project.

⚙️ Structure & Usage

This package is organized around a few core components that help structure application logic in a modular and maintainable way.

• Models, Factories, and Repositories

  Models, factories, and repositories work together to provide a consistent and efficient structure for handling data management within your application. Models define the structure of your data, factories simplify the creation of test or seed data, and repositories organize the access and manipulation of this data through a clear and testable interface.

  → Learn more

• Controllers

  Controllers are responsible for handling incoming HTTP requests, processing them (possibly using services or repositories), and returning appropriate responses. They serve as the entry point for web requests and help organize the application's logic.

  → Learn more

• Commands

  Custom Artisan commands that allow you to extend the CLI with domain-specific tasks. Useful for background jobs, setup scripts, or tooling.

  → Learn more

• Events

  Represent something that has happened in the domain. Events help decouple components and trigger side effects such as listeners or jobs.

  → Learn more

🧪 Testing & Maintainability

The separation encouraged by this package helps writing unit tests focused on commands and domain logic, keeping the codebase maintainable and clean.

📁 Examples

The package provides basic examples of:

• Models, Factories, and Repositories
• Controllers
• Commands with Handlers
• Events with Listeners

You can use them as a starting point for defining your own components.

📝 Contributing

Pull requests and issues are welcome! If you want to propose new features or improvements, feel free to open an issue.