Registry / devops / vite-plugin-runtime-cdn

vite-plugin-runtime-cdn

library1.0.3jsnpmunverified

A Vite plugin (v1.0.3) that replaces static CDN URLs at build time with runtime expressions (e.g., window.cdn_domain), enabling dynamic CDN domain configuration after deployment. Requires Vite >=2.9.0. Supports transforming CSS resource URLs when used with vite-plugin-inject-css-to-js. ESM-only, ships TypeScript types. Differentiator: runtime CDN domain, not build-time fixed URL.

devops

npm install vite-plugin-runtime-cdn

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-RUNTIM

vite-plugin-runtime-cdn

devopsjavascriptv1.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

RuntimeCdnPlugin

✓ import { RuntimeCdnPlugin } from 'vite-plugin-runtime-cdn'

✗ import RuntimeCdnPlugin from 'vite-plugin-runtime-cdn'

Named export, not default. Use ESM import.

RuntimeCdnPlugin (require)

✓ const { RuntimeCdnPlugin } = require('vite-plugin-runtime-cdn')

✗ const RuntimeCdnPlugin = require('vite-plugin-runtime-cdn')

CommonJS still works but ESM is preferred.

Default import

✓ import { RuntimeCdnPlugin } from 'vite-plugin-runtime-cdn'

✗ import RuntimeCdnPlugin from 'vite-plugin-runtime-cdn'

No default export; must use named import.

Basic usage: import the plugin and add to Vite config. Default runtime CDN domain is window.cdn_domain.

// vite.config.js import { defineConfig } from 'vite'; import { RuntimeCdnPlugin } from 'vite-plugin-runtime-cdn'; export default defineConfig({ plugins: [ RuntimeCdnPlugin() ] }); // Ensure window.cdn_domain is set before app code runs, e.g. in index.html: // <script>window.cdn_domain = 'https://cdn.example.com';</script>

Debug

Known issues

gotchaRequires Vite >=2.9.0

fix

Upgrade Vite to 2.9.0 or later.

affects: <2.9.0

gotchaCSS source URL transformation requires vite-plugin-inject-css-to-js

fix

Install and configure vite-plugin-inject-css-to-js, and set transformCssSourceURL: true.

affects: >=1.0.0

gotchaRuntime CDN domain must be available via window.cdn_domain (or custom placeholder) before app code executes

fix

Inject the CDN domain in index.html <script> or entry file.

affects: >=1.0.0

gotchaCSS files referenced in HTML entry cannot be transformed

fix

Import those CSS files into JS modules instead, or exclude them from transformation.

affects: >=1.0.0

deprecatedNo deprecated features in current version

fix

N/A

affects: none

Errors

Common errors & fixes

Error: Cannot find module 'es-module-lexer'

Missing peer dependency es-module-lexer

fix

npm install es-module-lexer

Error: Cannot find module 'magic-string'

Missing peer dependency magic-string

fix

npm install magic-string

[vite] Internal server error: Failed to resolve import "vite-plugin-runtime-cdn"

Plugin not installed

fix

npm install -D vite-plugin-runtime-cdn

TypeError: RuntimeCdnPlugin is not a function

Default import used instead of named import (import RuntimeCdnPlugin from ...)

fix

Use import { RuntimeCdnPlugin } from 'vite-plugin-runtime-cdn'

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

es-module-lexerrequiredpeer dependency for lexical analysis

magic-stringrequiredpeer dependency for string manipulation

viterequiredpeer dependency, >=2.9.0

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/Levix/vite-plugin-runtime-cdn ↗

packagevite-plugin-runtime-cdn ↗

homepagehttps://github.com/Levix/vite-plugin-runtime-cdn#readme ↗