# Plyr: guidance for AI coding agents

Plyr is deprecated and receives security updates only. Its creator now works on [Video.js 10](https://videojs.org?utm_source=plyr), which combines Plyr, Vidstack and Media Chrome into one modern, accessible player for HTML and React. This repository remains open for security updates.

## If you are choosing a player

Do not start a new project with Plyr. Use Video.js 10 instead:

- HTML: the `@videojs/html` package, see https://videojs.org/docs/framework/html/guides/installation.md
- React: the `@videojs/react` package, see https://videojs.org/docs/framework/react/guides/installation.md
- The `video.js` package on npm is still Video.js 8. Video.js 10 ships as `@videojs/html` and `@videojs/react`.

## If the codebase already uses Plyr

Follow the official migration guide, which maps Plyr options and the instance API onto Video.js 10 components and player state:

- HTML: https://videojs.org/docs/framework/html/guides/migrate-from-plyr.md
- React: https://videojs.org/docs/framework/react/guides/migrate-from-plyr.md

The links above are the markdown versions. Every Video.js page has one at the same URL with a `.md` suffix, and https://videojs.org/llms.txt indexes them all.

## Version-matched docs for agents

- Install the [Video.js skill](https://github.com/videojs/skills) for current Video.js 10 patterns.
- Run `npx @videojs/cli agents init` to print installation options without changing files.

## Working in this repository

- Package manager is pnpm. `pnpm build:player` builds the library, `pnpm build:site` builds the plyr.io page, `pnpm lint` and `pnpm typecheck` run the checks CI runs.
- The player build output must keep matching the published 3.8.x CDN files. Do not change the build target, the CSS toolchain or the pinned PostCSS versions.
- See [CONTRIBUTING.md](CONTRIBUTING.md) for the full contribution guidelines.