PHPackages                             ngiraud/laravel-starter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. ngiraud/laravel-starter

ActiveLibrary[Framework](/categories/framework)

ngiraud/laravel-starter
=======================

An opinionated starter to launch after creating a fresh Laravel application

v1.0.13(3mo ago)1385[1 PRs](https://github.com/ngiraud/laravel-starter/pulls)MITPHPPHP ^8.4CI passing

Since Aug 18Pushed 1mo agoCompare

[ Source](https://github.com/ngiraud/laravel-starter)[ Packagist](https://packagist.org/packages/ngiraud/laravel-starter)[ Docs](https://github.com/ngiraud/laravel-starter)[ GitHub Sponsors]()[ RSS](/packages/ngiraud-laravel-starter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (16)Used By (0)

An opinionated starter to launch after creating a fresh Laravel application
===========================================================================

[](#an-opinionated-starter-to-launch-after-creating-a-fresh-laravel-application)

[![Latest Version on Packagist](https://camo.githubusercontent.com/42732cef793b4603c3b26099a81721677944fa7642d92cbb06c5544c3ba224f6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6769726175642f6c61726176656c2d737461727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ngiraud/laravel-starter)[![GitHub Tests Action Status](https://camo.githubusercontent.com/a029b03c5b1f86a29b79240aabf86484f40792112c89488cffa12f18b2cd3adb/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e6769726175642f6c61726176656c2d737461727465722f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/ngiraud/laravel-starter/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/15ad0a9eeaece63444e1bb96b36ab0cfafba8274984fa31b666eea5411f43bc8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e6769726175642f6c61726176656c2d737461727465722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/ngiraud/laravel-starter/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/c660b43b68bee7a51e60db58786468238f4c80f6550c38d06b87570ab646479e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6769726175642f6c61726176656c2d737461727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ngiraud/laravel-starter)

This package automates the complete setup of a fresh Laravel application by installing and configuring the packages and tools you commonly use in your projects, with full Git management throughout the process.

It configures Docker Compose with Laravel Sail, installs your preferred packages (Telescope, Horizon, Filament, etc.), sets up Composer scripts for development, publishes configuration files and stubs, configures your environment according to your preferences (locale, database, services), and automatically creates semantic Git commits for each step.

Installation
------------

[](#installation)

Install the package in your fresh Laravel application:

```
composer require ngiraud/laravel-starter
```

Usage
-----

[](#usage)

After creating a new Laravel application with a starter kit, simply run:

```
php artisan starter:install
```

The command will guide you interactively through the complete setup process:

🔧 Environment Configuration
---------------------------

[](#-environment-configuration)

- **Application settings**: name, locale (fr/en), database configuration
- **Docker services**: MySQL, Redis, MinIO, Mailpit, Selenium, and more
- **Git repository**: automatic initialization and semantic commits throughout

📦 Package Management
--------------------

[](#-package-management)

- **Install Composer packages**: Laravel Telescope, Horizon, Filament, Larastan, Rector, etc.
- **Frontend dependencies**: automatic npm install via Sail
- **Service dependencies**: automatic installation (e.g., AWS S3 for MinIO)

🛠️ Development Environment
--------------------------

[](#️-development-environment)

- **Composer scripts**: `composer dev`, `composer test`, `composer lint`, `composer refactor`
- **Configuration files**: Pint, PHPStan, Rector configurations
- **GitHub Actions**: CI/CD workflows with proper service dependencies
- **Code quality**: automatic Rector and Pint formatting at the end

📁 Project Structure
-------------------

[](#-project-structure)

- **Custom stubs**: AppServiceProvider, User model, TestCase
- **Route management**: web-local.php for local development
- **Language files**: French translations if selected
- **Action command**: `php artisan make:action` for creating Action classes

📋 Available Packages
--------------------

[](#-available-packages)

The installer offers these carefully selected packages:

- **🔭 Laravel Telescope** - Debugging and monitoring dashboard
- **⏱️ Laravel Horizon** - Redis queue management and monitoring
- **🎛️ Filament** - Modern admin panel framework
- **🔍 Larastan** - Static analysis with PHPStan for Laravel
- **🔄 Rector** - Automated code refactoring and modernization
- **💾 Laravel Backup** - Database and file backup automation
- **⚡ Paratest** - Parallel test execution for faster testing
- **👀 Laravel Nightwatch** - Application monitoring and alerting

⚡ Development Scripts
---------------------

[](#-development-scripts)

The installer automatically adds these convenient Composer scripts:

```
composer dev      # Start all development services (logs, vite, queue)
composer dev:ssr  # Version with Inertia SSR support
composer test     # Run tests with coverage reporting
composer lint     # Code formatting with Laravel Pint
composer refactor # Automated refactoring with Rector
```

🚀 Installation Process
----------------------

[](#-installation-process)

The package follows a comprehensive workflow:

1. **Prerequisites check** - Ensures Laravel Sail is installed
2. **User preferences** - Interactive prompts for services and packages
3. **Git initialization** - Sets up repository with initial commit
4. **Environment setup** - Updates .env and .env.example files
5. **Sail installation** - Configures Docker services
6. **Package installation** - Installs selected Composer packages with individual commits
7. **File publishing** - Publishes stubs, configurations, and GitHub Actions
8. **Database migration** - Sets up initial database schema
9. **Code optimization** - Applies Rector and Pint formatting rules
10. **Completion** - Provides next steps for development

🛠️ PHPStorm Configuration
-------------------------

[](#️-phpstorm-configuration)

To optimize your development experience with PHPStorm, configure the following settings (**Settings** on Windows/Linux or **Preferences** on macOS):

### PHP Interpreter Setup

[](#php-interpreter-setup)

**Languages &amp; Frameworks → PHP**

1. **CLI Interpreter**

    - Click `+` to add a new interpreter
    - Select **From Docker, Vagrant, VM, WSL, Remote...**
    - Choose **Docker Compose** and select the `laravel.test` service
    - Verify the PHP version is detected correctly
2. **Language Level**

    - Set according to your project's PHP version (should match the remote interpreter)
3. **Test Frameworks**

    - Click `+` and select **PHPUnit** (or **Pest** if using Pest)
    - Choose **Use Composer autoloader** with the remote interpreter
    - Set the path to `vendor/autoload.php`
4. **Quality Tools → Laravel Pint**

    - Enable Laravel Pint
    - Configuration file: Leave default or specify `.pint.json` if you have one
    - **Note**: Using the remote interpreter may cause slower formatting but ensures consistency

### Development Automation

[](#development-automation)

**Tools → Actions on Save**

- ✓ Reformat code
- ✓ Optimize imports

### MCP Integration (Optional)

[](#mcp-integration-optional)

**Tools → AI Assistant → Model Context Protocol (MCP)**

- Enable **Laravel Boost** for enhanced Laravel development assistance

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Nicolas Giraud](https://github.com/ngiraud)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance85

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 94.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~12 days

Recently: every ~0 days

Total

14

Last Release

112d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12152071?v=4)[Nicolas Giraud](/maintainers/ngiraud)[@ngiraud](https://github.com/ngiraud)

---

Top Contributors

[![ngiraud](https://avatars.githubusercontent.com/u/12152071?v=4)](https://github.com/ngiraud "ngiraud (48 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

---

Tags

phplaravelpackagestarterLaravel Starter

###  Code Quality

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/ngiraud-laravel-starter/health.svg)

```
[![Health](https://phpackages.com/badges/ngiraud-laravel-starter/health.svg)](https://phpackages.com/packages/ngiraud-laravel-starter)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

732506.3k60](/packages/laravel-ai)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[lunarstorm/laravel-ddd

A Laravel toolkit for Domain Driven Design patterns

17959.0k](/packages/lunarstorm-laravel-ddd)[jonpurvis/squeaky

A Laravel Validation Rule to Help Catch Profanity.

706.0k](/packages/jonpurvis-squeaky)[bezhansalleh/filament-plugin-essentials

A collection of essential traits that streamline Filament plugin development by taking care of the boilerplate, so you can focus on shipping real features faster

27584.7k16](/packages/bezhansalleh-filament-plugin-essentials)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
