Laravel Tachyon is a powerful package designed to optimize the performance of your Laravel applications by minifying HTML output on demand. With over 35% optimization, it helps improve page load speed and overall user experience.
Laravel Tachyon supports the following:
-
Laravel Livewire: Laravel Tachyon seamlessly integrates with Laravel Livewire, allowing you to optimize the HTML output of your Livewire components.
-
Alpine JS: Laravel Tachyon is compatible with Alpine JS, ensuring that the optimization process does not interfere with the functionality of your Alpine JS components.
Additionally, Laravel Tachyon ensures that the optimization process does not break the following HTML elements:
-
<pre>: The content within<pre>tags, which is typically used for displaying preformatted text, is preserved and not modified during the optimization process. -
<textarea>: The content within<textarea>tags, which is used for input fields that allow multiple lines of text, is also preserved and not modified. -
<script>: The content within<script>tags, which is used for JavaScript code, is not modified by Laravel Tachyon. This ensures that your JavaScript code remains intact and functions as expected.
You can install the package via composer:
composer require dotninth/laravel-tachyonThis package supports Laravel Package Discovery.
To customize the package settings, you can publish the configuration file with the following command:
php artisan vendor:publish --provider="DotNinth\LaravelTachyon\ServiceProvider"To enable the package functionality, make sure to register the provided middlewares in the bootstrap/app.php file of your Laravel application. Here's an example of how to do it:
// bootstrap/app.php
return Application::configure(basePath: dirname(__DIR__))
...
->withMiddleware(function (Middleware $middleware) {
$middleware->append([
\DotNinth\LaravelTachyon\Middleware\RemoveComments::class,
\DotNinth\LaravelTachyon\Middleware\CollapseWhitespace::class,
\DotNinth\LaravelTachyon\Middleware\ElideAttributes::class,
\DotNinth\LaravelTachyon\Middleware\InlineCss::class,
\DotNinth\LaravelTachyon\Middleware\InsertDNSPrefetch::class,
\DotNinth\LaravelTachyon\Middleware\DeferJavascript::class,
]);
})
...RemoveComments::class- Removes HTML, JS, and CSS comments from the output to reduce the transfer size of HTML files.
CollapseWhitespace::class- Reduces the size of HTML files by removing unnecessary white space.
RemoveQuotes::class- Removes unnecessary quotes from HTML attributes, resulting in a reduced byte count on most pages.
ElideAttributes::class- Reduces the transfer size of HTML files by removing attributes from tags if their values match the default attribute values.
InsertDNSPrefetch::class- Includes
<link rel="dns-prefetch" href="//www.example.com">tags in the HTML<head>section to enable DNS prefetching, reducing DNS lookup time and improving page load times.
- Includes
TrimUrls::class- Trims URLs by making them relative to the base URL of the page. This can help reduce the size of URLs and may improve performance.
InlineCss::class- Transforms the inline
styleattribute of HTML tags into classes by moving the CSS into the<head>section, improving page rendering and reducing the number of browser requests.
- Transforms the inline
DeferJavascript::class- Defers the execution of JavaScript code in HTML, prioritizing the rendering of critical content before executing JavaScript.
- If you need to cancel the defer in some script, use
data-tachyon-no-deferas a script attribute to cancel the defer.
- If you need to cancel the defer in some script, use
- Defers the execution of JavaScript code in HTML, prioritizing the rendering of critical content before executing JavaScript.
Warning
Use TrimUrls::class middleware with care, as it can cause problems if the wrong base URL is used.
Important
CollapseWhitespace::class automatically calls the RemoveComments::class middleware before executing.
Note
You can ignore minification of some elements. Add data-tachyon-ignore as an element attribute to do so.
After installing the package, you may need to configure some options according to your needs.
To disable the Laravel Tachyon service in your local environment and get readable output, modify the following configuration file:
// config/laravel-tachyon.php
//Set this field to false to disable the Laravel Tachyon service.
'enable' => env('LARAVEL_TACHYON_ENABLED', true),You can configure the package to skip optimization for certain routes. Use the * wildcard to match multiple routes. Here's an example:
// config/laravel-tachyon.php
//You can use * as wildcard.
'skip' => [
'*.pdf', //Ignore all routes with final .pdf
'*/downloads/*',//Ignore all routes that contain 'downloads'
'assets/*', // Ignore all routes with the 'assets' prefix
];Feel free to adjust the configuration options according to your specific needs.
Notice: By default, the package automatically skips
binaryandstreamedresponses. See the File Downloads for more information.
$ composer testPlease see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.