Burn Plus
A WebGL organic burn/dissolve mask — warped multi-octave noise eats through a dark surface to reveal your media, driven by hover, scroll, tap, load, or direct control.
Installation#
pnpm dlx shadcn@latest add @davinciui/burn-plusUsage#
API Reference#
| Prop | Type | Default |
|---|---|---|
mediaImage or video URL used as the revealed surface. | string | — |
mediaTypeForce media kind; auto detects video by extension. | "image" | "video" | "auto" | "auto" |
fitCSS object-fit behaviour reproduced in UV space. | "cover" | "contain" | "fill" | "cover" |
burnReveal threshold 0–1. With trigger="manual" this is the live controlled value. | number | 0.7 |
densityBurn field frequency 0–1: broad regions at 0, fine detail at 1. | number | 0.5 |
distortionBoundary turbulence 0–1: smooth contours at 0, aggressive warp at 1. | number | 0.38 |
edgeSoftnessEdge half-width in field units 0–1. | number | 0.05 |
noiseScaleBase frequency multiplier for the noise domain. | number | 1 |
octavesFBM octave count 1–5. Higher adds finer breakup. | number | 4 |
seedPattern offset. Changing it rejumps the field; burn never does. | number | 1 |
edgeComplexityFine breakup weight concentrated near the moving edge. | number | 0.6 |
startAnimation endpoint: burn value at progress 0. | number | 0 |
endAnimation endpoint: burn value at progress 1. | number | 1 |
completeAtReveal progress that resolves the held frame into fully visible media. | number | 1 |
qualityDesktop DPR cap for the backing buffer. | number | 1.75 |
mobileQualityDPR cap on coarse-pointer devices. | number | 1.25 |
backgroundColour of burned-away regions. | string | "#000000" |
invertFlip the mask: burn hides instead of reveals. | boolean | false |
triggerWhat drives the burn progress uniform. | "manual" | "load" | "hover" | "tap" | "inview" | "scroll" | "manual" |
directionPlayback direction; alternate ping-pongs when looping. | "reveal" | "hide" | "alternate" | "reveal" |
autoplayStart load/inview animations automatically. | boolean | true |
loopReplay continuously after the completed state is held. | boolean | false |
loopDelayMilliseconds to hold the completed reveal before restarting a loop. | number | 1200 |
delayAutostart delay in milliseconds. | number | 0 |
durationFull-sweep duration in milliseconds. | number | 2000 |
transitionEasing for time-based tweens (not scroll scrubbing). | "linear" | "easeIn" | "easeOut" | "easeInOut" | "custom" | "easeInOut" |
transitionBezierCustom cubic-bezier used when transition="custom". | [number, number, number, number] | [0.42, 0, 0.58, 1] |
scrollStartScroll-window start (element entering = 0). | number | 0 |
scrollEndScroll-window end (element leaving = 1). | number | 1 |
scrollSmoothingScrub follow lag 0–0.99; 0 tracks raw scroll. | number | 0.25 |
ariaLabelAccessible label; the canvas itself is hidden from AT. | string | "Burn reveal effect" |
Accessibility#
Exposes the effect as a role img host with a configurable aria label while the canvas is aria-hidden. Tap mode listens only to pointerup, so its reveal has no keyboard equivalent.
Motion#
Time-based triggers tween burn progress using duration, transition and transitionBezier, while scroll mode uses scrollSmoothing. prefers-reduced-motion is watched live and jumps straight to the final endpoint without a tween.
View source
Keep in mind
Need a custom component?
I build bespoke UI components & websites tailored to your brand.

