Co-authored-by: videojs-release[bot] <324600730+videojs-release[bot]@users.noreply.github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
@videojs/cdn
Browser-ready Video.js bundles for script-tag and self-hosted installations. This package assembles the HTML player, selected playback adapters, shared chunks, source maps, and standalone stylesheets in one build graph.
Replace <version> with the same exact package version in every CDN URL. A version range can resolve URLs to different
releases, whose entry files and shared chunks do not match.
Load a player and one media implementation:
<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@<version>/video.js"></script>
<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@<version>/media/hlsjs-video.js"></script>
The browser-ready entry URLs are:
| Entry | URL |
|---|---|
| Media | @videojs/cdn@<version>/media/<media-name>.js |
| Extension | @videojs/cdn@<version>/extensions/<extension-name>.js |
| UI element | @videojs/cdn@<version>/ui/<element-name>.js |
Adapter and extension runtimes are already included in these bundles, so do not add the npm packages to a script-tag installation.
AI Quickstart
Using an AI coding agent? Install the Video.js skill so it reads the docs that
match this package version before writing code. Then print a complete CDN installation. The command downloads only the
small @videojs/cli package, not this browser distribution:
npx @videojs/cli agents init --framework html --method cdn
Build output
Run pnpm build:cdn from the workspace root. The task writes publishable files directly to packages/cdn/, which is
the npm package root; it does not use a separate dist directory. Player entries sit at the top level.
Locale, media, extension, and UI element entries sit under locales, media, extensions, and ui.
pnpm --filter @videojs/cdn run build:archive writes the self-hosting zip, tarball, and checksums to
packages/cdn/archive/ after the CDN build completes.
Self-hosting
Install the package when the browser-ready directory will be copied to your own origin:
pnpm add @videojs/cdn
Copy every file in the published package. Entry files import shared chunks by relative URL.
Application builds should install @videojs/html or @videojs/react instead. Neither package depends on
@videojs/cdn, so normal npm installs do not include these prebuilt bundles.