viteAsset()

Signature

viteAsset() — returns string

Available in: controller Category: Asset Functions

Description

Returns the resolved URL for a Vite entrypoint. In production, reads the Vite manifest to return the fingerprinted asset path. In development, returns the Vite dev server URL.

Parameters

Name	Type	Required	Default	Description
entrypoint	string	yes	—	The source entrypoint path as defined in your Vite config (e.g. “src/main.js”).

Examples

// 1. Get the resolved URL for a Vite JS entrypoint
// In production, returns a fingerprinted path like "/dist/assets/main-Dz8C9a3m.js"
// In development, returns the Vite dev server URL like "http://localhost:5173/src/main.js"
assetUrl = viteAsset("src/main.js");

// 2. Use the resolved URL directly in an image or font tag
logoUrl = viteAsset("src/images/logo.png");
writeOutput('<img src="#logoUrl#" alt="Logo">');

// 3. Resolve a CSS entrypoint URL for manual use (e.g. a preload hint)
cssUrl = viteAsset("src/main.css");
writeOutput('<link rel="preload" as="style" href="#cssUrl#">');