It wears your product
On a dark streaming app, Kerf takes its orange and its 26 px corners. Nothing else changes.
A Video.js 10 skin built on one cut. The picture makes room for the controls, so they always sit on solid ground, in your product's own colour.
kerf, noun. The slot a saw leaves in the material it cuts.
The picture at the bottom. The frame cut to make room. The notches that rise from it.
Over the brightest frame in the film.
Previews and menus grow out of the band, from the control that opened them.
Kerf takes the host's surface, accent and radius. No fork, no rebuild.
On a dark streaming app, Kerf takes its orange and its 26 px corners. Nothing else changes.
Accent and radius in your stylesheet, the surface on the skin root. No fork, no rebuild.
/* your stylesheet */
.kerf {
--media-accent-color: #f2552c;
--media-border-radius: 26px;
}
<!-- the skin root -->
<media-container class="media-skin kerf"
data-surface="dark">
A white frame, a cobalt accent, 12 px corners.
Violet on a soft lilac page, settings rising flush right.
Set the outer corner. The inner one and every notch follow.
It fills the seek bar, the active rate and play on hover. Nowhere else.
Same frame, same radii, one accent. Drawn here; every one of them runs on the Player page.
The player decides by its own width, not the screen's. Targets stay 44 px.
One radius system, two speeds, no exceptions.
Accessibility is the structure, not a layer on top.
Controls never sit on footage. They sit on the frame: ink on frame is 17:1 on dark and 18:1 on light, the same over a white sky or a black night.
Tab follows the screen, left to right. Escape closes a menu and returns focus to its button.
A 2 px ink ring with a 2 px cut on every button, menu item and on the blade itself.
44 px targets on every screen size. The seek bar is 44 px tall, the blade 24 by 44.
Reduced motion makes every change instant. Reduced transparency changes nothing: every surface is already solid.
Labels, states and announcements come from Video.js and its translations, including right to left.
Canvas for the frame, CanvasText for ink, Highlight for the fill and the focus ring.
Most players float their controls over the picture, then fight the picture for contrast with gradients and blur. Kerf cuts the picture instead. The controls live in a notch of the player's own frame, a solid surface in the host product's colour, so they read the same over a white sky or a black night.
Everything that opens rises out of that frame from the control that asked for it, and sinks back when the film plays. Transient feedback hangs from the top edge. One radius system, one accent, the official solid icons, tabular time. Familiar to use, unmistakable to look at.
Plain HTML and CSS on Video.js 10. Copy it in, own it.
1
npm install @videojs/html2
Take skin/src/video/ and skin/src/styles/ from the Kerf repository, then import it once.
import './video/skin';3
Put your media where the skin marks it. Any Video.js media works: a video file, HLS or Mux.
<video-player>
<!-- skin.html, with your media inside -->
<mux-video src="https://stream.mux.com/{id}.m3u8"></mux-video>
</video-player>4
.kerf {
--media-accent-color: #d4f53c;
--media-border-radius: 20px;
}
/* on the skin root: data-surface="light" | "auto",
data-motion="reduce", data-poster-controls="show" */Kerf on the Sparvek film
Scrub the chapters, open the menus, change the accent and the radius. Every switch is a property your product can set.
Open the player