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 ideal-creative-lab/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="IdealCreativeLab\LaravelTachyon\ServiceProvider"To enable the package functionality, make sure to register the provided middlewares in the kernel of your Laravel application. Here's an example of how to do it:
// app/Http/Kernel.php
protected $middleware = [
...
\IdealCreativeLab\LaravelTachyon\Middleware\InlineCss::class,
\IdealCreativeLab\LaravelTachyon\Middleware\ElideAttributes::class,
\IdealCreativeLab\LaravelTachyon\Middleware\InsertDNSPrefetch::class,
\IdealCreativeLab\LaravelTachyon\Middleware\RemoveQuotes::class,
\IdealCreativeLab\LaravelTachyon\Middleware\CollapseWhitespace::class,
\IdealCreativeLab\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.- It automatically calls the
RemoveComments::classmiddleware before executing. - You can ignore minification of some elements. Add
data-tachyon-ignoreas an element attribute to do so.
- It automatically calls the
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.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.⚠️ Note: Use this middleware with care, as it can cause problems if the wrong base URL is used.
InlineCss::class: Transforms the inlinestyleattribute of HTML tags into classes by moving the CSS into the<head>section, improving page rendering and reducing the number of browser requests.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
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.