PHPackages jamesclark32/dev-audit - 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. [CLI & Console](/categories/cli) 4. / 5. jamesclark32/dev-audit ActiveLibrary[CLI & Console](/categories/cli) jamesclark32/dev-audit ====================== Quickly run a set of CLI commands and summarize their outcome 1.1.2(1y ago)05.1k—7.1%[4 PRs](https://github.com/Jamesclark32/dev-audit/pulls)MITPHPPHP ^8.2CI passing Since Aug 25Pushed 2mo ago1 watchersCompare [ Source](https://github.com/Jamesclark32/dev-audit)[ Packagist](https://packagist.org/packages/jamesclark32/dev-audit)[ Docs](https://github.com/jamesclark32/dev-audit)[ GitHub Sponsors]()[ RSS](/packages/jamesclark32-dev-audit/feed)WikiDiscussions main Synced 2d ago READMEChangelog (1)Dependencies (12)Versions (11)Used By (0) Dev Audit ========= [](#dev-audit) [![Latest Version on Packagist](https://camo.githubusercontent.com/cf23c8012c2a057d325f4b5bcc04877907b52d1bf469962782666838e072ad8b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4a616d6573636c61726b33322f6465762d61756469742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/:vendor_slug/:package_slug)[![GitHub Tests Action Status](https://camo.githubusercontent.com/4de1e2ee28fa72d7d4c3796feaa9e453d6d48fd2e5705d3590b61ba44653b9ad/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4a616d6573636c61726b33322f6465762d61756469742f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/:vendor_slug/:package_slug/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/b3a2a7eaf6ec1346213825ef4204c1b65d4e2f8986f6c6ff7cd07a9444685075/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f4a616d6573636c61726b33322f6465762d61756469742f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/:vendor_slug/:package_slug/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/6870c91bca8593a81bc3ddabdba1d870107243a38764b26350df9ecb0c74d4d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4a616d6573636c61726b33322f6465762d61756469742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/:vendor_slug/:package_slug) This package provides a Laravel console command to quickly run a set of CLI commands and summarize their outcome. Dev Audit is intended to encapsulate a series of audits regularly run together as part of a development process, such as a pre-merge routine. The package ships with an opinionated set of default audits based upon the author's workflow but is easily modified to suit yours instead. Out of the box, Dev Audit runs: - Tests (phpunit) - Static Analysis (phpstan) - Lint check against changed PHP files (pint) - Lint check against changed javascript files (prettier) - Composer audit - Npm audit Note that this includes [phpstan](https://github.com/larastan/larastan) and [prettier](https://github.com/prettier/prettier) which require separate installation and configuration in a Laravel project. Once installed, Dev Audit can be run at any time using `artisan dev:audit`. Under the hood, Dev Audit executes the commands from the configuration via an instance of `Symfony/Process` and serves as a UI wrapper to summarize the results while removing feedback clutter. Typical output looks something like this: [![img.png](img.png)](img.png) Linters ------- [](#linters) This package also contains a command, `dev:lint` to run linters. You can run this command at any time you choose. You can also run the linters as part of the audit by adding the `--lint` flag thusly: `php artisan dev:audit --lint`. If you always want the linters to run as part of the audit process, you can get control this by setting settings.always\_lint to true in the dev-audit configuration file. Installation ------------ [](#installation) To get started, you need only to install the package via composer: It is recommended to only require the package for development. ``` composer require --dev jamesclark32/dev-audit ``` Once installed, Dev Audit can be run at any time using `artisan dev:audit`. Configuration ------------- [](#configuration) To adjust the audits to be run, simply publish and modify the config file. You can publish the config file to `config/dev-audit.php` with: ``` php artisan vendor:publish --tag="dev-audit-config" ``` The config files contains the details of the audits to run. Audits can be added, removed, modified, or have their order adjusted. Any new audits need only a `title` for display purposes and the `command` to run. `failure_hint` content is optional, but provides the opportunity to display commands needed for likely next steps in the case of a failure. The default audit configuration looks like this, requiring a few third-party packages: ``` return [ 'settings' => [ 'always_lint' => false, ], 'audits' => [ [ 'title' => 'Tests', 'command' => './vendor/bin/pest', ], [ 'title' => 'Test coverage', 'command' => './vendor/bin/pest --coverage --min=80', ], [ 'title' => 'Type coverage', 'command' => './vendor/bin/pest --type-coverage --min=100', ], [ 'title' => 'PHPStan type check', 'command' => './vendor/bin/phpstan analyze -v --memory-limit=-1', ], [ 'title' => 'Pint PHP linting (dirty files only)', 'command' => './vendor/bin/pint --dirty --test', ], [ 'title' => 'Prettier JS linting (dirty files only)', 'command' => 'npm run format:check:dirty', 'failure_hint' => 'Run "npm run format:check:dirty', ], [ 'title' => 'Peck typo check', 'command' => './vendor/bin/peck', ], [ 'title' => 'Rector code quality', 'command' => './vendor/bin/rector --dry-run', ], [ 'title' => 'Composer Audit', 'command' => 'composer audit', ], [ 'title' => 'NPM Audit', 'command' => 'npm audit', ], ], 'linters' => [ [ 'title' => 'Pint (dirty files only)', 'command' => './vendor/bin/pint --dirty', ], [ 'title' => 'Rector', 'command' => './vendor/bin/rector', ], [ 'title' => 'Prettier (dirty files only)', 'command' => 'npm run format:dirty', ], [ 'title' => 'ESX', 'command' => 'npm run lint', ], ], ]; ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - [James Clark](https://github.com/Jamesclark32) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 42 — FairBetter than 88% of packages Maintenance66 Regular maintenance activity Popularity22 Limited adoption so far Community10 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 70.6% 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 ~49 days Total 5 Last Release 481d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/13315960?v=4)[James Clark](/maintainers/jamesclark32)[@Jamesclark32](https://github.com/Jamesclark32) --- Top Contributors [![Jamesclark32](https://avatars.githubusercontent.com/u/13315960?v=4)](https://github.com/Jamesclark32 "Jamesclark32 (24 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)") --- Tags laravelJamesClark32dev-audit ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jamesclark32-dev-audit/health.svg) ``` [![Health](https://phpackages.com/badges/jamesclark32-dev-audit/health.svg)](https://phpackages.com/packages/jamesclark32-dev-audit) ``` ### Alternatives [spatie/laravel-pdf Create PDFs in Laravel apps 1.0k4.8M47](/packages/spatie-laravel-pdf)[harris21/laravel-fuse Circuit breaker for Laravel queue jobs. Protect your workers from cascading failures. 44855.7k](/packages/harris21-laravel-fuse)[vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24857.5k](/packages/vormkracht10-laravel-mails)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[backstage/mails View logged mails and events in a beautiful Filament UI. 16120.0k](/packages/backstage-mails)[spatie/laravel-openapi-cli Create a Laravel command for your OpenAPI spec(s). Works in apps and other packages. Useful for AI agents. 391.5k12](/packages/spatie-laravel-openapi-cli) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)