CompressedStaticFiles 2.2.0
dotnet add package CompressedStaticFiles --version 2.2.0
NuGet\Install-Package CompressedStaticFiles -Version 2.2.0
<PackageReference Include="CompressedStaticFiles" Version="2.2.0" />
paket add CompressedStaticFiles --version 2.2.0
#r "nuget: CompressedStaticFiles, 2.2.0"
// Install CompressedStaticFiles as a Cake Addin #addin nuget:?package=CompressedStaticFiles&version=2.2.0 // Install CompressedStaticFiles as a Cake Tool #tool nuget:?package=CompressedStaticFiles&version=2.2.0
<p align="center"> <a href="https://github.com/AnderssonPeter/CompressedStaticFiles"> <img src="icon.svg" alt="Logo" width="80" height="80"> </a>
<h3 align="center">CompressedStaticFiles</h3>
<p align="center"> Send compressed static files to the browser without having to compress on demand, also has support for sending more advanced image formats when the browser has support for it. <br /> <br /> · <a href="https://github.com/AnderssonPeter/CompressedStaticFiles/issues">Report Bug</a> · <a href="https://github.com/AnderssonPeter/CompressedStaticFiles/issues">Request Feature</a> · </p> </p> <br />
Table of Contents
About The Project
This project allows you to serve precompressed files to the browser without having to compress on demand, this is achieved by compressing/encoding your content at build time.
Getting Started
Precompress content
Static nonimage files have to be precompressed using Zopfli and/or Brotli, see the example for how to do it with gulp.
The files must have the exact same filename as the source + .br
or .gzip
(index.html
would be index.html.br
for the Brotli version).
Encode images
Modern browsers support new image formats like webp and avif they can store more pixels per byte.
You can convert your images using the following tools webp and libavif.
The files must have the same filename as the source but with a new file extension (image.jpg
would be image.webp
for the webp version).
ASP.NET
Add AddCompressedStaticFiles()
in your Startup.ConfigureServices()
method.
Replace UseStaticFiles();
with UseCompressedStaticFiles();
in Startup.Configure()
.
By default CompressedStaticFiles is configured to allow slightly larger files for some image formats as they can store more pixels per byte, this can be disabled by calling CompressedStaticFileOptions.RemoveImageSubstitutionCostRatio()
.
Example
A example can be found in the Example directory.
By using this package the Lighthouse mobile performance went from 76
to 98
and the transferred size went from 526 kb
to 141 kb
.
Acknowledgements
This solution is based on @neyromant from the following issue https://github.com/aspnet/Home/issues/1584#issuecomment-227455026.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net6.0
- No dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
2.2.0
Added support for Zstandard compression
2.1.0
Added support for space in filenames
Added support for RequestPath
Added support for .net 6.0
Removed support for .net 5.0
Removed support for .net 3.1
2.0.0
Added support for alternative image formats
Added support for .net 5
Removed support for .net core 2.1
1.2.0
Added support for .net core 3.1
1.1.0
New feature: Ability to specify a custom FileProvider (now using the FileProvider provided in the StaticFileOptions if it is set)
1.0.4
Converted to .NET Standard 1.6
1.0.3
Fixed issue that disabled caching parameters.
1.0.2
Added support for IIS.
1.0.1
Added logging
Picks original file if its the smallest
Added support for .NETFramework 4.5.1
1.0.0
Initial release