astro-compressor
A gzip and brotli compressor for Astro
- Simple: Set it and forget it
- Optimal: By compressing ahead of time, a more performant compression can be performed
Table of Contents
Table of Contents
NOTE
- Important: It is important that this is the last integration in the
integrations
property to ensure all the generated files are compressed. - Note: This only works for static exports, SSR does not export assets that can
be compressed ahead of time so you need to solve it with middleware. See this
for more context and a partial solution.
Quickstart
Install via your tool of choice:
npx astro add astro-compressor
yarn astro add astro-compressor
pnpm astro add astro-compressor
To compress your files, simply run pnpm build
and look for the compression messages in the build log.
Usage
First, install the package with your favorite package manager: pnpm add --dev astro-compressor
,
then configure it in your astro.config.*
file in the integrations
property:
import { defineConfig } from "astro/config";
import compressor from "astro-compressor";
export default defineConfig({
integrations: [..., compressor()],
});
Configuration
You can also optionally enable and/or disable either the gzip or brotli compression by
passing an options object to the compressor:
import { defineConfig } from "astro/config";
import compressor from "astro-compressor";
export default defineConfig({
integrations: [..., compressor({ gzip: true, brotli: false })],
});
Or customize the file formats that will be compressed:
import { defineConfig } from "astro/config";
import compressor from "astro-compressor";
export default defineConfig({
integrations: [..., compressor({
fileExtensions: [".html"]
})],
});
By default the fileExtensions
array is [".css", ".js", ".html", ".xml", ".cjs", ".mjs", ".svg", ".txt"]
.
License
MIT.