README

# Statamic Site Health

A plain-English site-health dashboard for the Statamic control panel. It runs a set of automated checks — disk space, cache, debug mode, environment and app optimisation — and presents them as colour-coded cards with "what this means" and "how to fix it" guidance written for non-developers, not just engineers.

Built on top of spatie/laravel-health and surfaced inside Statamic as a CP Utility plus a top-level Tools nav link.

Features

• Five checks out of the box — used disk space (warn > 70%, fail > 90%), cache, debug mode, environment, optimised app.
• Plain English — every check has a "what it means" line and a "how to fix" box, so clients and editors understand the result, not just developers.
• At-a-glance status — passing / warning / needs-attention counts.
• Development-aware — checks that only matter in production (debug mode, environment, optimised app) are flagged as expected in dev and go green automatically once deployed.
• Zero config — registers itself via Laravel package discovery; nothing to publish.

Requirements

PHP	^8.3
Statamic	^6.0
Laravel	^13.0
spatie/laravel-health	^1.40 (installed automatically)

Installation

composer require alexhalchenko/site-health

The addon auto-registers. Open the control panel and you'll find Site Health under Utilities, plus a shortcut in the Tools nav.

Usage

Nothing to configure. Open CP → Utilities → Site Health. Each card shows the check name and status, a short summary value (e.g. disk usage %), and — when something needs attention — a "how to fix" box with concrete next steps.

In a non-production environment a banner reminds you that debug mode, environment and optimised app are expected to be red locally; they only need to pass on the live site.

Tuning the checks

Checks are registered in src/ServiceProvider.php using spatie/laravel-health's fluent API:

UsedDiskSpaceCheck::new()
    ->warnWhenUsedSpaceIsAbovePercentage(70)
    ->failWhenUsedSpaceIsAbovePercentage(90),

Add, remove or re-tune checks to taste — see the spatie/laravel-health docs.

License

MIT — © dnsk.work.

**[dnsk.work](https://dnsk.work)** — a UI/UX design agency without the agency part.
Senior-led, embedded, no six-week process.