# VideoSkin

The video preset's default skin with the modern, frosted look

The default skin of the video preset: the control layout for on-demand video with the modern, frosted look. The preset also provides [NeutralVideoSkin](https://videojs.org/docs/framework/react/reference/components/video-neutral-skin), [CompatVideoSkin](https://videojs.org/docs/framework/react/reference/components/video-compat-skin), and [ScaffoldVideoSkin](https://videojs.org/docs/framework/react/reference/components/video-scaffold-skin). See [Skins](https://videojs.org/docs/framework/react/guides/skins#choose-a-skin) to choose between them and [Presets](https://videojs.org/docs/framework/react/guides/presets) for what the video preset ships.

## Import

```tsx
import { VideoSkin } from '@videojs/react/video';
import '@videojs/react/video/skin.css';
```

## Anatomy

The skin goes between the player and the media component. It renders its controls around the media.

```tsx
<VideoPlayer>
  <VideoSkin>
    <Video />
  </VideoSkin>
</VideoPlayer>
```

## Poster

The skin renders a poster image before playback starts. Pass `renderPoster` to replace it with your own component.

See [Add a poster and loading placeholder](https://videojs.org/docs/framework/react/guides/poster) for complete examples.

## Thumbnail

The skin renders a storyboard preview image while scrubbing the time slider. Pass `renderThumbnail` to replace it with your own image, for example to set `crossOrigin`, `loading`, or `fetchPriority`.

See [Show timeline thumbnail previews](https://videojs.org/docs/framework/react/guides/thumbnails) for complete examples.

## Controls before playback

Before playback starts, the skin shows only the large center play button. The other controls appear once playback starts or the media begins to autoplay. Set `--media-controls-before-start: visible` to show them from the start. See [Customize skins](https://videojs.org/docs/framework/react/guides/customize-skins#set-the-skins-styles).

## Styling

Packaged skins style themselves and expose a small set of public CSS custom properties. Everything else inside the skin is private and may change between releases. [Customize skins](https://videojs.org/docs/framework/react/guides/customize-skins#style-a-packaged-skin) documents the properties. For deeper changes, the Video.js registry provides the skin files.

## Examples

### Basic Usage

**App.tsx**

```tsx
import { Video, VideoPlayer, VideoSkin } from '@videojs/react/video';

import '@videojs/react/video/skin.css';

export default function BasicUsage() {
  return (
    <VideoPlayer poster="https://image.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/thumbnail.jpg">
      <VideoSkin className="react-video-skin-basic">
        <Video src="https://stream.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/highest.mp4" playsInline crossOrigin="anonymous">
          <track kind="metadata" label="thumbnails" src="https://image.mux.com/BV3YZtogl89mg9VcNBhhnHm02Y34zI1nlMuMQfAbl3dM/storyboard.vtt" default />
        </Video>
      </VideoSkin>
    </VideoPlayer>
  );
}
```

**App.css**

```css
.react-video-skin-basic {
  width: 100%;
  aspect-ratio: 16 / 9;
}
```

## Own the UI

Packaged skins keep their controls and layout inside Video.js. When you need to add, remove, rearrange, or deeply restyle controls, use Shadcn to add the skin source to your project. Its components, layout, styles, and interactions become local files you can change.

- [Install Video.js with Shadcn](https://videojs.org/docs/guides/installation/shadcn?framework=react#choose-how-to-install): Add editable skin source and build a working React or HTML player

---

React documentation: https://videojs.org/docs/framework/react/llms.txt
All documentation: https://videojs.org/llms.txt
