Installation
Choose your framework. The registry installs the component and its runtime dependency.
Installation unavailable
The preview is public, but its installable release is still being prepared.
The registry command writes the component to src/lib/components/ui/FluidWatercolorReveal.svelte and installs its dependencies.
The registry command writes the component to src/components/ui/FluidWatercolorReveal.tsx and installs its dependencies.
The registry command writes the component to src/components/ui/FluidWatercolorReveal.vue and installs its dependencies.
Basic usage
The shader fills its parent. Your layout decides whether that parent is a card, hero, or viewport.
Component API
Types below match the selected Svelte component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius used to gather nearby colors into painted regions.
- Type
number- Default
6- Range / values
1–12
Paper color used in the monochrome rendering.
- Type
string- Default
"#F4F1E8"
Ink color used in the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural grain across the paper surface.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
1- Range / values
0–2
Detail level of the fluid motion along the shorter edge.
- Type
number- Default
256- Range / values
32–256
Detail level of the color field along the shorter edge.
- Type
number- Default
1024- Range / values
128–1024
How quickly injected color fades from the fluid.
- Type
number- Default
1- Range / values
0–4
How quickly the fluid motion loses momentum.
- Type
number- Default
0.05- Range / values
0–4
Amount of pressure retained between simulation steps.
- Type
number- Default
0.8- Range / values
0–1
Number of pressure passes used to preserve fluid volume. Higher values improve accuracy and cost more to render.
- Type
number- Default
1- Range / values
1–40
Strength of the small rolling eddies in the fluid.
- Type
number- Default
0- Range / values
0–50
Width of the fluid affected by pointer movement.
- Type
number- Default
0.87- Range / values
0.01–1
Momentum added to the fluid by pointer movement.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer painting of the watercolor reveal. Disabling stops new strokes without clearing the existing simulation.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy
Types below match the selected React component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius used to gather nearby colors into painted regions.
- Type
number- Default
6- Range / values
1–12
Paper color used in the monochrome rendering.
- Type
string- Default
"#F4F1E8"
Ink color used in the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural grain across the paper surface.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
1- Range / values
0–2
Detail level of the fluid motion along the shorter edge.
- Type
number- Default
256- Range / values
32–256
Detail level of the color field along the shorter edge.
- Type
number- Default
1024- Range / values
128–1024
How quickly injected color fades from the fluid.
- Type
number- Default
1- Range / values
0–4
How quickly the fluid motion loses momentum.
- Type
number- Default
0.05- Range / values
0–4
Amount of pressure retained between simulation steps.
- Type
number- Default
0.8- Range / values
0–1
Number of pressure passes used to preserve fluid volume. Higher values improve accuracy and cost more to render.
- Type
number- Default
1- Range / values
1–40
Strength of the small rolling eddies in the fluid.
- Type
number- Default
0- Range / values
0–50
Width of the fluid affected by pointer movement.
- Type
number- Default
0.87- Range / values
0.01–1
Momentum added to the fluid by pointer movement.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer painting of the watercolor reveal. Disabling stops new strokes without clearing the existing simulation.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
FluidWatercolorRevealHandle- Range / values
pause, resume, reset, resize, destroy
Types below match the selected Vue component.
Additional classes for the parent-sized root element.
- Type
string
URL or data URL processed by the watercolor and fluid passes.
- Type
string- Range / values
Image URL or data URL
Controls how the source image is placed inside the canvas.
- Type
"cover" | "fit" | "stretch"- Default
"cover"- Range / values
cover, fit, stretch
Radius used to gather nearby colors into painted regions.
- Type
number- Default
6- Range / values
1–12
Paper color used in the monochrome rendering.
- Type
string- Default
"#F4F1E8"
Ink color used in the monochrome watercolor rendering.
- Type
string- Default
"#181715"
Strength of the procedural grain across the paper surface.
- Type
number- Default
1- Range / values
0–2
Saturation of the watercolor color revealed by the fluid mask.
- Type
number- Default
1- Range / values
0–2
Detail level of the fluid motion along the shorter edge.
- Type
number- Default
256- Range / values
32–256
Detail level of the color field along the shorter edge.
- Type
number- Default
1024- Range / values
128–1024
How quickly injected color fades from the fluid.
- Type
number- Default
1- Range / values
0–4
How quickly the fluid motion loses momentum.
- Type
number- Default
0.05- Range / values
0–4
Amount of pressure retained between simulation steps.
- Type
number- Default
0.8- Range / values
0–1
Number of pressure passes used to preserve fluid volume. Higher values improve accuracy and cost more to render.
- Type
number- Default
1- Range / values
1–40
Strength of the small rolling eddies in the fluid.
- Type
number- Default
0- Range / values
0–50
Width of the fluid affected by pointer movement.
- Type
number- Default
0.87- Range / values
0.01–1
Momentum added to the fluid by pointer movement.
- Type
number- Default
6000- Range / values
0–10000
Softness of the fluid color boundary.
- Type
number- Default
0.22- Range / values
0.01–0.49
Stops the render loop while keeping the current frame visible.
- Type
boolean- Default
false
Enables pointer painting of the watercolor reveal. Disabling stops new strokes without clearing the existing simulation.
- Type
boolean- Default
true- Range / values
true, false
Caps render resolution independently from the element size.
- Type
number- Default
2- Range / values
1–3
Scales GPU resolution without changing layout dimensions.
- Type
number- Default
1- Range / values
0.25–1
Runs after the shader is mounted successfully, including a WebGL fallback.
- Type
(backend: ShaderBackend) => void- Range / values
webgpu, webgl
Runs when automatic initialization changes the requested WebGPU backend to WebGL.
- Type
(backend: ShaderBackend, reason: string) => void- Range / values
webgl
Reports source-loading or renderer failures so the host application can decide how to recover.
- Type
(error: Error) => void
Exposes the imperative component lifecycle methods.
- Type
Component public instance- Range / values
pause, resume, reset, resize, destroy