Files
videojs-release[bot]andgithub-actions[bot] a5fdd3cab5 chore: release main (#9758)
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>
2026-11-16 14:27:12 -08:00
..
2026-10-08 07:32:16 +11:00
2026-11-16 14:27:12 -08:00
2026-11-16 14:27:12 -08:00

@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.

License

Apache-2.0