Astro-generic-build-filenames NPM

`astro-generic-build-filenames`

This is an Astro integration that modifies the filenames of build assets to more generic names.
This package is designed to eliminate confusion caused by the default naming convention, which names files after their entry points.

After astro build, asset files have a name based on the entry point, which result in main stylesheet names like 404.[hash].css or about-us.[hash].js. The same happens to assets and chunks.

Provided workarounds like directly setting vite.build.rollupOptions.output.entryFileNames do not work reliably with adapters like @astrojs/vercel or @astrojs/cloudflare.

This integration provides a wrapper around the originally used vite.build.rollupOptions.output.*FileNames keys and just replaces [name] with 'entry', 'chunk' or 'asset'.

Usage

Prerequisites

Your normal Astro project.

Installation

Install the integration automatically using the Astro CLI:

pnpm astro add astro-generic-build-filenames

npx astro add astro-generic-build-filenames

yarn astro add astro-generic-build-filenames

Or install it manually:

Install the required dependencies

pnpm add astro-generic-build-filenames

npm install astro-generic-build-filenames

yarn add astro-generic-build-filenames

Add the integration to your astro config

+import genericBuildFilenames from "astro-generic-build-filenames";

export default defineConfig({
  integrations: [
+    genericBuildFilenames(),
  ],
});