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.1.5(2mo ago)1394[3 PRs](https://github.com/ngiraud/laravel-starter/pulls)MITPHPPHP ^8.4CI passing

Since Aug 18Pushed 2mo 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 today

READMEChangelog (10)Dependencies (27)Versions (27)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/bfa48503ce5304c3aa88961d1171bd0e91f32e0469af618477ddf0d50d6b3c7e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6e6769726175642f6c61726176656c2d737461727465722f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/ngiraud/laravel-starter/actions?query=workflow%3ATests+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: installing and configuring your preferred packages and tools, 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 and npm scripts for development, publishes configuration files and stubs, configures your environment (locale, database, services), and automatically creates semantic Git commits for each step.

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

[](#installation)

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

Usage
-----

[](#usage)

### Full setup

[](#full-setup)

Run the interactive installer on a fresh Laravel application:

```
php artisan starter:install
```

It will guide you through the complete setup and delegate to the sub-commands below. At the end it offers to remove itself from your project.

### Individual commands

[](#individual-commands)

Each step is also available as a standalone command, usable at any time after initial setup:

CommandDescription`starter:init``git init` + `.env` configuration (name, locale, database)`starter:add {package}`Install a package + post-install steps + commit`starter:remove {package}`Remove a package + cleanup + commit`starter:publish`Publish config stubs, scripts, GitHub Actions, and opt-in extras`starter:finalize`Run `composer lint` (Rector + Pint) and commitAvailable packages
------------------

[](#available-packages)

KeyPackageDefault`telescope`Laravel Telescope✓`horizon`Laravel Horizon—`filament`Filament—`larastan`Larastan✓`rector`Rector (Laravel)✓`backup`Laravel Backup—`paratest`Paratest—`nightwatch`Laravel Nightwatch—What gets published
-------------------

[](#what-gets-published)

`starter:publish` sets up the following, with opt-in prompts for extras:

- **Config files**: `pint.json`, `AppServiceProvider.php`, `TestCase.php`
- **Routes**: `web-local.php` (local-only routes, auto-required in `web.php`)
- **GitHub Actions**: tests, lint, phpstan (if Larastan), rector (if Rector)
- **Language files**: French translations if locale is `fr`
- **Composer scripts**: `dev`, `lint`, `test`, `test:lint`, `test:types`, `test:all`
- **npm scripts**: `dev`, `lint`, `test:lint`
- **`.gitignore`**: adds `/.claude` entry
- **AI guidelines** *(opt-in)*: `.ai/guidelines/` stubs for testing and conventions
- **Action design pattern** *(opt-in)*: `Action`, `Fakeable`, `FakeAction`, `FakeableTest`, `MakeActionCommand` + `make:action` stub
- **EnhanceEnum trait** *(opt-in)*: `app/Enums/Concerns/EnhanceEnum.php`

Development scripts
-------------------

[](#development-scripts)

After running the installer, these scripts are available in your project:

```
composer dev        # Start all dev services concurrently (logs, vite, queue)
composer lint       # Rector + Pint + ESLint
composer test       # Run the test suite
composer test:lint  # Dry-run lint (CI)
composer test:types # PHPStan (if Larastan installed)
composer test:all   # Full CI suite
```

Testing
-------

[](#testing)

```
composer test
```

Local development
-----------------

[](#local-development)

Two helper scripts are provided to wire up the package as a local path repository in a target project:

```
# Add path repo + minimum-stability: dev to the project's composer.json
./scripts/setup-local.sh my-laravel-project

# Mount the package into the project's Sail compose file
./scripts/setup-sail.sh my-laravel-project
```

Both scripts resolve paths automatically relative to their own location (assumes projects live alongside `laravel-packages/` in the same parent directory).

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

46

—

FairBetter than 92% of packages

Maintenance86

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 95.2% 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 ~13 days

Recently: every ~1 days

Total

20

Last Release

74d 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 (60 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

TestsPest

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.

1.0k3.2M194](/packages/laravel-ai)[laravel/boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, Laravel-specific code.

3.5k21.5M590](/packages/laravel-boost)[wnx/laravel-backup-restore

A package to restore database backups made with spatie/laravel-backup.

213420.9k2](/packages/wnx-laravel-backup-restore)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[nativephp/mobile

NativePHP for Mobile

1.1k75.1k91](/packages/nativephp-mobile)

PHPackages © 2026

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