Registry / devops / vite-plugin-dynamic-publicpath

vite-plugin-dynamic-publicpath

library1.1.2jsnpmunverified

Vite plugin that enables dynamic runtime public path for assets and chunks, similar to webpack's __webpack_public_path__. Version 1.1.2 is current. Works by wrapping dynamic imports with a custom handler that can rewrite import URLs at runtime. Notable as one of few Vite-specific solutions for dynamic public paths; relies on modifying Vite's build output and requires careful ordering with legacy plugin. Suitable for multi-CDN or dynamic base path scenarios.

devops

npm install vite-plugin-dynamic-publicpath

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-DYNAMI

vite-plugin-dynamic-publicpath

devopsjavascriptv1.1.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

useDynamicPublicPath

✓ import { useDynamicPublicPath } from 'vite-plugin-dynamic-publicpath'

✗ const useDynamicPublicPath = require('vite-plugin-dynamic-publicpath')

Package is ESM-only; named export.

dynamicImportHandler option

✓ useDynamicPublicPath({ dynamicImportHandler: 'window.__myHandler__' })

✗ new useDynamicPublicPath({ dynamicImportHandler: 'window.__myHandler__' })

Not a constructor; call as function with options object.

dynamicImportPreload option

✓ useDynamicPublicPath({ dynamicImportPreload: 'window.__myPreload__' })

Specify custom property name for preload handler.

Set up dynamic public path in vite config and define handlers in entry script.

import { defineConfig } from 'vite'; import { useDynamicPublicPath } from 'vite-plugin-dynamic-publicpath'; export default defineConfig({ plugins: [ useDynamicPublicPath({ dynamicImportHandler: 'window.__dynamic_handler__', dynamicImportPreload: 'window.__dynamic_preload__' }) ] }) // Then in your entry script, define the handlers: window.__dynamic_handler__ = function(importer) { return 'https://cdn.example.com' + importer; } window.__dynamic_preload__ = function(preloads) { return preloads.map(preload => 'https://cdn.example.com' + preload); }

Debug

Known issues

gotchaPlugin must be placed after any plugin that transforms imports (e.g., @vitejs/plugin-legacy) to avoid incorrect URL rewriting.

fix

Ensure useDynamicPublicPath is listed after plugins like legacy in the plugins array.

affects: >=0.0.0

breakingThe plugin modifies dynamic import() calls; it may not work correctly with other plugins that also transform imports (e.g., Vite's built-in optimizer).

fix

Test with complex vite setups; consider using only one import transformation plugin.

affects: >=0.0.0

gotchaHandlers must be defined before any dynamic import occurs; otherwise imports will use original public path.

fix

Define window.__dynamicImportHandler__ (or custom) in a script that runs before any lazy-loaded chunk.

affects: >=0.0.0

deprecatedThe option 'assetsBase' is marked as default 'assets' but may not be documented clearly; behavior may change.

fix

Check documentation for 'assetsBase' if customizing directory; default is 'assets'.

affects: >=1.0.0

Errors

Common errors & fixes

Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'vite-plugin-dynamic-publicpath'

Package not installed or incorrectly imported.

fix

Run 'npm install vite-plugin-dynamic-publicpath --save-dev' and use 'import { useDynamicPublicPath } from 'vite-plugin-dynamic-publicpath''.

Dynamic import handler is not being called

Handlers defined after dynamic imports trigger, or plugin not applied correctly.

fix

Define window.__dynamicImportHandler__ before any import() in the entry point. Ensure plugin is in vite config plugins array.

Uncaught TypeError: window.__dynamicImportHandler__ is not a function

Handler function not defined or overwritten.

fix

Define handler as: window.__dynamicImportHandler__ = function(importer) { return 'your-cdn' + importer; }

Upgrade

Version history

1.1.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/jy0529/vite-plugin-dynamic-publicpath ↗

packagehttps://www.npmjs.com/package/vite-plugin-dynamic-publicpath ↗