README

Pest plugin for checking that Laravel Blade views are rendered by your test suite.

It is built for package-heavy Laravel applications where normal PHP coverage excludes resources/views/**/*.blade.php. The plugin records views that Laravel actually renders, then compares uncovered views against a committed hash baseline so CI only fails for new or changed uncovered Blade files.

Install

composer require capell-app/pest-plugin-blade-coverage --dev

If the package is not available through Packagist yet, add a VCS repository first:

{
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/capell-app/pest-plugin-blade-coverage"
        }
    ]
}

Configure

Create tests/blade-coverage.php:

<?php

declare(strict_types=1);

return [
    'include' => [
        'packages/*/resources/views/**/*.blade.php',
    ],
    'exclude' => [],
    'baseline' => 'tests/BladeCoverage/baseline.json',
    'cache' => '.cache/pest-blade-coverage',
];

Add a Composer script:

{
    "scripts": {
        "coverage:blade": "@php vendor/bin/pest --blade-coverage --configuration=phpunit.xml"
    }
}

Usage

Run the check:

composer coverage:blade

Create or refresh the baseline:

vendor/bin/pest --blade-coverage --blade-coverage-update-baseline --configuration=phpunit.xml

The baseline update command refuses to write a baseline when target views exist but no views were rendered. This usually means the selected tests did not exercise Blade output. If that is intentional, use the explicit override:

vendor/bin/pest --blade-coverage --blade-coverage-update-baseline --blade-coverage-allow-empty-baseline --configuration=phpunit.xml

Use a custom config path:

vendor/bin/pest --blade-coverage --blade-coverage-config=tests/custom-blade-coverage.php

Write a machine-readable report for CI summaries or annotations:

vendor/bin/pest --blade-coverage --blade-coverage-json=coverage/blade-coverage.json --configuration=phpunit.xml

Coverage Rules

A Blade file is covered only when Laravel renders it.
Included partials and component views count because Laravel renders them.
Reading a Blade file with file_get_contents() does not count.
Existing uncovered views are allowed only while their content hash matches the baseline.
New uncovered views and changed uncovered views fail the run.
Parallel Pest runs are supported through JSON shards in the configured cache directory.

Failure Examples

If a package adds a Blade file but no test renders it:

Blade view coverage
  1 covered, 0 baseline-allowed, 1 new uncovered, 0 changed uncovered, 2 total
  New uncovered Blade views:
    blog:
      - packages/blog/resources/views/sidebar.blade.php

This fails the Pest process with exit code 1.

If a Blade file was already baseline-uncovered and its contents change without adding render coverage:

Blade view coverage
  0 covered, 0 baseline-allowed, 0 new uncovered, 1 changed uncovered, 1 total
  Changed uncovered Blade views:
    blog:
      - packages/blog/resources/views/sidebar.blade.php

This also fails with exit code 1. Fix either case by adding a test that renders the view through Laravel, or by deleting the Blade file if it is genuinely unused.

Baseline Format

The baseline stores uncovered views by normalized path and content hash. It also stores metadata that helps catch accidental config drift:

{
    "schemaVersion": 1,
    "generatedAt": "2026-06-01T17:00:00+00:00",
    "summary": {
        "total": 174,
        "covered": 22,
        "uncovered": 152,
        "baselineAllowed": 152,
        "newUncovered": 0,
        "changedUncovered": 0
    },
    "config": {
        "include": ["packages/*/resources/views/**/*.blade.php"],
        "exclude": [],
        "hash": "..."
    },
    "views": {
        "packages/admin/resources/views/example.blade.php": "..."
    }
}

Older baselines that contain only a path-to-hash object are still supported.

Publishing To Packagist

This package is ready for normal Composer distribution once the GitHub repository is public and tagged.

Log in to Packagist.
Open Submit Package.
Enter the public repository URL:

https://github.com/capell-app/pest-plugin-blade-coverage

Submit the package. Packagist reads the package name from composer.json.
Enable the GitHub/Packagist hook when prompted so new tags update immediately.

After Packagist accepts it, consumers can remove the Composer repositories VCS entry and install the package normally:

composer require --dev capell-app/pest-plugin-blade-coverage:^0.1

capell-app / pest-plugin-blade-coverage

Maintainers

Package info

Statistics

Security