PHPackages                             lform/pretty-code - 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. [Utility & Helpers](/categories/utility)
4. /
5. lform/pretty-code

ActivePackages[Utility & Helpers](/categories/utility)

lform/pretty-code
=================

Lform's centrally managed code style & linting configurations

1.2.0(8mo ago)055[1 PRs](https://github.com/lform/pretty-code/pulls)MITShellPHP ^7.4|^8.0

Since May 2Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/lform/pretty-code)[ Packagist](https://packagist.org/packages/lform/pretty-code)[ RSS](/packages/lform-pretty-code/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (10)Used By (0)

Pretty Code
===========

[](#pretty-code)

**Pretty Code** is a githook-driven collection of linter & formatter configurations for PHP, CSS, HTML, and JavaScript. It is also designed for per-project customization, which is useful when dealing with older, unconventional, or problematic code bases.

When this package is updated, running `composer update` or `npm update` will pull in the latest configuration changes, minus anything you've overridden in your project. This allows for easy updates to the configuration without having to manually update files.

### Table of Contents

[](#table-of-contents)

1. [Requirements](#requirements)
2. [Installation](#installation)
3. [Initialization](#initialization)
4. [Commands](#commands)
5. [Customization per Project](#customization-per-project)

Requirements
------------

[](#requirements)

- Environments: OSX, Linux, WSL
- PHP 7.4+
- Node 20+

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

[](#installation)

> IMPORTANT: The NPM part of the package must be installed to use the githook-driven linters and formatters. That is the case for PHP as well, regardless of whether you are using the Composer package.

This package is designed to work in Linux and OSX environments. Windows is not supported at this time.

### NPM Installation

[](#npm-installation)

This installs the frontend part of the package as well as the githook-driven automations.

```
npm install --save-dev @lform/pretty-code
```

### Composer Installation

[](#composer-installation)

This installs the PHP part of the package.

```
composer require --dev lform/pretty-code
```

### Laravel & PHPStan

[](#laravel--phpstan)

For Laravel based projects, install Larastan, which will configure PHPStan for use in Laravel projects.

- [Larastan Documentation & Repo](https://github.com/larastan/larastan)

#### Installing Larastan

[](#installing-larastan)

1. Install Larastan (refer to documentation) via Composer
2. Create a `phpstan.neon` file in the project root or copy the one from `pretty-code`
3. Edit the `.lintstagedrc.json` file and remove the preset configuration path from `phpstan`, so it uses the project root configuration by default.
4. Add the larastan extension to the `phpstan.neon` file in the project root:

    includes: - vendor/larastan/larastan/extension.neon

Initialization
--------------

[](#initialization)

Once the packages are installed, the package has to be initialized via `npm` to do a few things:

1. Copy a `.lintstagedrc.json` config to the project root, if it does not already exist
2. Copy a preconfigured `.githooks` directory to the project root to trigger the git automations. If the directory already exists, the initialization script will not overwrite it.
3. Copy a `.editorconfig` config to the project root, if it does not already exist
4. Configure the project git repo `core.hooksPath` to use the new `.githooks` directory.
5. Add new scripts in `package.json` to run the linters and formatters manually.

For Composer, initialization will just add the new scripts to `composer.json` to run the linters and formatters manually.

Afterward, these new files & changes should be committed to git once everything is confirmed working. Read below for how to initialize the package.

### NPM Initialization

[](#npm-initialization)

```
npx pretty-code init
```

### Composer Initialization

[](#composer-initialization)

```
vendor/bin/pretty-code init
```

### Troubleshooting

[](#troubleshooting)

#### PHPStan Pains

[](#phpstan-pains)

PHPStan is very helpful but can be a source of aggravation on projects that have an older code-base or used unconventional approaches. There are a few things that can be done to address these issues:

1. If it's a Laravel project, install Larastan (instructions are above)
2. Exclude files from reporting in the configuration or with inline comments. For errors that should be ignored, add them to the configuration.
3. Lower the reporting level in the configuration
4. Generate a baseline report, so you can focus on new code instead of trying to fix old code. Commit the baseline report to the project repo.

If all else fails, PHPStan can be disabled but this should be avoided except when necessary.

#### Disconnecting & Reconnecting the Automations

[](#disconnecting--reconnecting-the-automations)

If you're having problems with the automated git hooks and need to disable or re-enable them:

```
# Disable automations, set the git hooks to the default:
git config core.hooksPath ".git/hooks"

# Re-enable automations, set the git hooks to our custom hooks directory:
git config core.hooksPath ".githooks"
```

#### OS Issues

[](#os-issues)

**NOTE**: On OSX, you may also need to install `coreutils` since the initialization scripts use the `realpath` command. If you see errors related to this, run the following:

```
brew install coreutils
```

### Uninstalling

[](#uninstalling)

To remove the package:

1. Delete any custom linter or formatter configs from the project root
2. Delete the `.githooks` directory
3. Run `git config core.hooksPath .git/hooks`
4. Run `npm remove @lform/pretty-code`
5. Run `composer remove lform/pretty-code`
6. Remove the `pretty` scripts from `composer.json` and `package.json`

Linters & Formatters
------------------------

[](#linters--formatters)

### Linters

[](#linters)

- [ESLint](https://eslint.org/)
- [linthtml](https://linthtml.vercel.app/)
- [PHPStan](https://phpstan.org/)
- [StyleLint](https://stylelint.io/)

### Formatters

[](#formatters)

- [PHP CS Fixer](https://cs.symfony.com/)
    - Configured for PHP 8.3, for 7.4 support, copy the configuration into your project and customize it.
- [Prettier](https://prettier.io/)

Supported File Types
--------------------

[](#supported-file-types)

> L = Linted, F = Formatted

- antlers.html (F)
- antlers.php (F)
- blade.php (F)
- css (LF)-
- html, htm (LF)
- js (LF)
- jsx (LF)
- json (F)
- pcss (LF)
- php (LF)
- scss (LF)
- ts (LF)
- tsx (LF)
- twig (F)
- yaml, yml (LF)

Commands
--------

[](#commands)

### Formatters

[](#formatters-1)

```
# Runs Prettier (css, scss, pcss, js, jsx, ts, tsx, json, html, htm, twig, blade.php, yml, yaml)
npm run pretty:format

# Runs PHP-CS-Fixer (php)
composer pretty:format
```

### Linters

[](#linters-1)

```
# Runs StyleLint (css, scss, pcss)
npm run pretty:lint:css

# Runs ESLint (js, jsx, ts, tsx, json)
npm run pretty:lint:js

# Runs linthtml (html, htm)
npm run pretty:lint:html

# Runs PHPStan (php)
composer pretty:lint
```

Customization Per Project
-------------------------

[](#customization-per-project)

To customize the linters and formatters per project:

1. Copy the specific configuration files that need to be modified from the Pretty Code package root to the project root. Only copy the configurations that you need, these custom configs will no longer get updated via the package management system.
2. Modify the copied configuration files as needed.
3. Open the `.lintstagedrc.json` file and remove the explicit config-file paths or ignore-file paths from the respective linters or formatters being adjusted.
4. Do the same thing for the `package.json` and `composer.json` scripts as applicable.
5. The linters and formatters with project-based configs will automatically use the configuration files from the project root directory.

To undo these changes, just delete the configurations and restore the original scripts by referencing the package's `package.json` and `composer.json` files.

Configuration Files
-------------------

[](#configuration-files)

- `.eslintrc.json`
- `.eslintignore (if applicable)`
- `.linthtmlrc.json`
- `.prettierrc.json`
- `.prettierignore`
- `.stylelint.json`
- `.stylelintignore`
- `phpstan.neon`

Todos
-----

[](#todos)

1. Add github workflows
2. Add tailwind linter
3. Add antlers formatter + linter
4. Add windows support (convert bin scripts to node.js)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance60

Regular maintenance activity

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.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 ~96 days

Recently: every ~118 days

Total

6

Last Release

265d ago

PHP version history (2 changes)1.0.0PHP >=8.0

1.0.1PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/d218008f5f5e5e84728e88ac039ac09b751d40b10a3fb7b990e3960677495588?d=identicon)[lform](/maintainers/lform)

---

Top Contributors

[![innoscience](https://avatars.githubusercontent.com/u/6894281?v=4)](https://github.com/innoscience "innoscience (44 commits)")[![Code-Derek](https://avatars.githubusercontent.com/u/66320617?v=4)](https://github.com/Code-Derek "Code-Derek (3 commits)")

### Embed Badge

![Health badge](/badges/lform-pretty-code/health.svg)

```
[![Health](https://phpackages.com/badges/lform-pretty-code/health.svg)](https://phpackages.com/packages/lform-pretty-code)
```

###  Alternatives

[ticketswap/phpstan-error-formatter

A minimalistic error formatter for PHPStan

87578.8k35](/packages/ticketswap-phpstan-error-formatter)[shopsys/coding-standards

Coding standards definition compatible with PSR-2

20269.1k13](/packages/shopsys-coding-standards)[rich-davis1/phpw2v

A PHP implementation of Word2Vec, a popular word embedding algorithm created by Tomas Mikolov and popularized by Radim Řehůřek & Peter Sojka with the Gensim Python library.

481.2k](/packages/rich-davis1-phpw2v)

PHPackages © 2026

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