@minimalhtml/vite

Vite plugin for MinimalHtml. Pairs with the MinimalHtml.Vite NuGet package.

What it does

• Scans .cs files for marker comments to discover entry points
• Sets build.manifest = true so the .NET side can read .vite/manifest.json
• Disables modulePreload (server emits preload <link> tags from manifest imports)
• Enables Rolldown chunkImportMap to emit .vite/importmap.json
• Sets a sensible default entryFileNames (assets/[name]-[hash].js)
• Emits Subresource Integrity hashes (SHA-384) into the manifest via vite-plugin-manifest-sri

Install

pnpm add -D @minimalhtml/vite vite

Requires Vite 8+ (Rolldown). The chunkImportMap feature is Rolldown experimental.

Usage

// vite.config.ts
import { defineConfig } from "vite";
import minimalHtml from "@minimalhtml/vite";

export default defineConfig({
  plugins: [minimalHtml()],
});

Marker convention

Prepend /*vite*/ to any string literal that names an asset. The plugin scans .cs files for the pattern and feeds the literal to Vite's input list.

return Assets.Script(/*vite*/"src/main.ts");
return Assets.Style(/*vite*/"src/styles/main.css");

Default scan glob: ./**/*.cs. Default ignored: bin/, obj/, node_modules/.

Options

minimalHtml({
  scan: ["./**/*.cs"],            // globs to scan
  marker: "vite",                 // marker token
  ignore: ["**/bin/**", ...],     // glob ignores
  inputs: ["./extra.ts"],         // extra explicit inputs
  entryFileNames: "assets/[name]-[hash].js",
  disableImportMap: false,        // skip chunkImportMap emission
  importMapBaseUrl: "/",
  importMapFileName: ".vite/importmap.json",
  disableIntegrity: false,        // skip SRI hash emission
  integrityAlgorithms: ["sha384"], // hash algorithms
  integrityManifestPaths: [".vite/manifest.json"],
});

Subresource Integrity

Each manifest entry receives an integrity field (sha384-<base64> by default). The .NET side reads it into Asset.Integrity; rendering helpers should emit it as <script integrity="..."> / <link integrity="...">.

When integrity is set, the browser requires crossorigin on the tag. Same-origin assets are fine without it; for assets served from a different origin (CDN, separate static host), emit crossorigin="anonymous" together with integrity. Example helper logic:

{IfTrueish("integrity", asset.Integrity)}
{IfTrueish("crossorigin", asset.Integrity is null ? null : "anonymous")}

Disable SRI emission entirely with disableIntegrity: true if your deploy target doesn't need it.

Pairing with the .NET side

// Program.cs
builder.Services.RegisterViteAssets(importmapPath: ".vite/importmap.json");

See the main repo README for the full picture.

License

MIT