assetPrefix#

• Type: boolean | string | 'auto'
• Default: '/'

Set the URL prefix of static assets during development.

assetPrefix will affect the URLs of most of the static assets, including JavaScript files, CSS files, images, videos, etc. If an incorrect value is specified, you'll receive 404 errors while loading these resources.

This config is only used during development. In the production environment, please use the output.assetPrefix to set the URL prefix.

Boolean Type#

If assetPrefix is set to true, the URL prefix will be http://localhost:port/:

export default {
  dev: {
    assetPrefix: true,
  },
};

The script URL will be:

<script defer src="http://localhost:8080/static/js/main.js"></script>

If assetPrefix is set to false or not set, / is used as the default value.

String type#

When the value of assetPrefix is string type, the string will be used as the URL prefix:

export default {
  dev: {
    assetPrefix: 'http://example.com/assets/',
  },
};

The script URL will be:

<script defer src="http://example.com/assets/static/js/main.js"></script>

Compare with publicPath#

dev.assetPrefix corresponds to the following native configurations:

• output.publicPath configuration in webpack.
• output.publicPath configuration in Rspack.

The differences from the native configuration are as follows:

• dev.assetPrefix only takes effect during development.
• dev.assetPrefix automatically appends a trailing / by default.
• The value of dev.assetPrefix is written to the process.env.ASSET_PREFIX environment variable (can only be accessed in client code).