Installation

Install the package

pnpm add @moviie/player-react

The same with npm or yarn:

npm install @moviie/player-react
# or
yarn add @moviie/player-react

The package brings its own playback engine (Vidstack and hls.js) as regular dependencies, so there is nothing else to install for playback.

Peer dependencies

@moviie/player-react declares react and react-dom as peer dependencies:

• react ≥ 19
• react-dom ≥ 19

These are versions you already have in any modern React app, so no extra install is needed.

Import the stylesheet

Import the player stylesheet once, anywhere in your app (for example in your root layout or your global CSS entry):

import "@moviie/player-react/styles.css"

The stylesheet ships the player chrome and the design tokens that drive theming. Without it the player renders unstyled. See Configuration: theming for how to customize the accent color and tokens.

Related packages

You only need to install @moviie/player-react: it re-exports the data layer (MoviieClient, playback types, typed errors, telemetry) and the contract constants for you.