alangiacomin / laravel-base-pack
Laravel base pack
Requires
- php: ^8.2|^8.3|^8.4
- alangiacomin/php-utils: ^v1.0.0
- laravel/framework: ^12.8.1
Requires (Dev)
- laravel/pint: ^1.22.0
- orchestra/testbench: ^10.2.1
- pestphp/pest: ^3.8.1
This package is auto-updated.
Last update: 2025-06-23 18:40:25 UTC
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.
-
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.
-
Commands
Custom Artisan commands that allow you to extend the CLI with domain-specific tasks. Useful for background jobs, setup scripts, or tooling.
-
Events
Represent something that has happened in the domain. Events help decouple components and trigger side effects such as listeners or jobs.
🧪 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.