netnak/minimatic

v1.0.5 2025-06-10 14:53 UTC

Requires

• statamic/cms: ^4.0 || ^5.0
• voku/html-min: ^4.4

MIT

README

Minimatic is a Statamic addon that minifies HTML responses and/or static cached pages using voku/html-min.

🚀 Features

Minimatic wraps the powerful HtmlMin engine and exposes its configuration through a publishable config file. You can toggle the following features:

• doOptimizeViaHtmlDomParser() – optimize HTML using the DOM parser
• doRemoveComments() – remove HTML comments
• doSumUpWhitespace() – collapse excess whitespace
• doRemoveWhitespaceAroundTags() – trim whitespace around tags
• doOptimizeAttributes() – optimize HTML attributes
• doRemoveHttpPrefixFromAttributes() – strip http: from attributes
• doRemoveHttpsPrefixFromAttributes() – strip https: from attributes
• doKeepHttpAndHttpsPrefixOnExternalAttributes() – preserve prefixes for external links
• doMakeSameDomainsLinksRelative(['example.com']) – make internal links relative
• doRemoveDefaultAttributes() – remove default attribute values
• doRemoveDeprecatedAnchorName() – remove deprecated anchor name attributes
• doRemoveDeprecatedScriptCharsetAttribute() – remove charset from <script> tags
• doRemoveDeprecatedTypeFromScriptTag() – remove deprecated type from <script>
• doRemoveDeprecatedTypeFromStylesheetLink() – remove type="text/css" from CSS links
• doRemoveDeprecatedTypeFromStyleAndLinkTag() – remove type="text/css" globally
• doRemoveDefaultMediaTypeFromStyleAndLinkTag() – remove media="all"
• doRemoveDefaultTypeFromButton() – remove type="submit" from buttons
• doRemoveEmptyAttributes() – strip empty attributes
• doRemoveValueFromEmptyInput() – remove value="" from empty inputs
• doSortCssClassNames() – sort class names for better Gzip performance
• doSortHtmlAttributes() – sort attributes for better Gzip performance
• doRemoveSpacesBetweenTags() – aggressively trim inter-tag spaces
• doRemoveOmittedQuotes() – omit unnecessary attribute quotes
• doRemoveOmittedHtmlTags() – omit redundant HTML tags

📦 Installation

Install via Composer:

composer require netnak/minimatic

Then publish the config file (optional):

php artisan vendor:publish --tag=minimatic-config --force

⚙️ Configuration

Minimatic auto-registers its own replacer at runtime.

However, if you want to manually ensure it's added as a static caching replacer, edit config/statamic/static_caching.php:

'replacers' => [
    // ...
    \Netnak\Minimatic\Replacers\MinimaticReplacer::class,
],

✅ Usage

Enable minification via your .env file:

MINIFY_RESPONSE=true
MINIFY_STATIC=true

These values toggle options in config/minimatic.php:

'enable_response_minifier' => env('MINIFY_RESPONSE', false),
'enable_static_cache_replacer' => env('MINIFY_STATIC', false),

Exclude paths from minification with:

'ignored_paths' => ['!/*', 'api/*'],

🪪 License

MIT — see the LICENSE file for details.