Fluid Typing

Fixed and animated text or visitor-written text over liquid ripples, with click interaction and palettes for light and dark themes.

Text over a fluid background. Animated with React Drops.

Controls

Preset

Effect preset

Typing

Static text
Typing mode
Text
Type speed (ms)
Delete speed (ms)
Hold duration (ms)
Loop typing
Opening wave
Opening pause (ms)
Natural rhythm
Cursor

Ripples

Ripple layers
Ripple width
Seed
Border radius (px)

Refraction

Ripple blur
Distortion
Turbulence scale
Wave height

Interaction

Click interaction
Click strength

Colors

Theme
Background color
Blue color
Lavender color
Highlight color

Playback

Speed
Paused
Frame limit
Resolution scale
Pixel ratio limit
Pixel budget

Properties

42 properties
PropertyTypeDefaultDescription
staticTexttextA fixed prefix displayed alongside the animated, static, or manually entered text.
typingModeauto | manual | staticautoAnimate the message, let the visitor type directly, or show the complete text.
defaultValuetextInitial text for uncontrolled manual input. Replay restores this value.
placeholdertextType here…Prompt shown when the manual input is empty.
inputLabeltextYour textAccessible name of the manual text field.
textstring | string[]Text over a fluid background. Animated with React Drops.Text to type. A string array creates consecutive lines in the same message.
typeSpeednumber110Average time between typed characters. Every character emits one wave at the caret.
deleteSpeednumber50Time between deleted characters. Deletion emits a weaker wave.
holdDurationnumber1800Hold the complete message before deleting and repeating.
introWavebooleantrueStart each automatic cycle with one large wave from the lone cursor, then pause before typing.
introPausenumber900Time between the opening wave and the first character.
naturalRhythmbooleantrueSize every wave by the typing speed: slow keystrokes emit broad, strong waves and quick bursts small, soft ones. Automatic typing also follows a person's uneven rhythm. Turn off for a steady rate with identical waves.
autoTypebooleantrueType the text automatically. Turn off to show controlled text directly and emit waves from its changes.
loopbooleantrueDelete and retype the complete message. Turn off to keep the completed text visible.
cursorbooleantrueDisplay the blinking text caret. Wave positions still follow its location when hidden.
rippleCountnumber7Maximum active ripple layers. Each typed character emits a new wave from the caret.
rippleWidthnumber0.09Width of each ripple before blur, relative to the composition height.
seednumber1Choose a repeatable arrangement of fluid distortion.
borderRadiusnumber0Round the outer corners of the effect independently of the preview window.
blurnumber0.035Blur each ripple before distortion. Rose Lagoon defaults to 0.035; the Original preset uses 0.05, corresponding to about 54 px in a 1080 px composition.
distortionnumber0Bend the blurred ripples with fluid turbulence. Rose Lagoon uses zero distortion; the Original preset's 0.0133 corresponds to Amount 14.4 in a 1080 px composition.
turbulenceScalenumber0.093Size of the folds in the fluid distortion. The default corresponds to Turbulent Displace Size 100 in a 1080 px composition.
refractionnumber0.87Strength of the broad luminous water ripples, corresponding to the tutorial's Caustics Water Wave Height.
interactivebooleantrueClick or tap the surface to emit a liquid ripple at that position. Foreground buttons, links, and inputs keep their own behavior.
interactionStrengthnumber1.4Strength of click and tap waves. Zero disables pointer emissions without affecting typing waves.
paletteauto | turquoise | rose-lagoon | silk | opal | aurora | rose | glacier | solar | graphiterose-lagoonGradient palette. Rose Lagoon is the default; Turquoise, Silk, Opal, Aurora, Rose, Glacier, Solar and Graphite are also available, and "auto" uses the original page-adaptive colors. The catalog applies palettes from its Preset menu.
themeauto | light | darklightLight keeps the palette's light colors on any page theme. Automatic follows the page theme, and Dark uses the palette's dark variation.
backgroundColorstringautomaticAutomatic background color unless overridden. An empty string follows the selected palette and theme.
blueColorstringautomaticCool tint inside the fluid ripples. An empty string follows the selected palette and theme.
lavenderColorstringautomaticSoft secondary tint in the refracted folds. An empty string follows the selected palette and theme.
highlightColorstringautomaticLight reflected along the ripple ridges. An empty string follows the selected palette and theme.
speednumber0.25Playback speed. Zero holds the current frame.
pausedbooleanfalseHold the current frame and resume from the same position.
maxFpsnumber60Maximum drawing rate. This does not change playback speed.
resolutionScalenumber0.75Scale the drawing buffer to balance sharpness and GPU work.
maxDprnumber1.5Limit the drawing resolution on high-density displays.
maxPixelsnumber1000000Maximum number of pixels in the drawing buffer.
value / onValueChangestring / (value: string) => voiduncontrolledControl manual input from React state, or omit value to use defaultValue and internal state. The callback receives committed text, including pasted text and composition input.
refFluidRipplesHandle—pause() and play() control typing and waves together. reset() and seek(seconds) change only the waves. rippleAt(x, y, strength?, size?) emits a wave at normalized coordinates; size 1 matches a keystroke and larger drops spread broader, faster waves.
childrenReactNode—Content layered above the fluid surface.
className / stylestring / CSSProperties—Customize the outer container and responsive size.
aria-labelstring—Optional image description. Omit for a decorative background.

Usage

Usage
import { FluidTyping } from './components/fluid-typing';

export function Example() {
  return (
    <FluidTyping
      text={["Text over a fluid background.","Animated with React Drops."]}
    />
  );
}

Free for personal and commercial projects. Redistributing components, kits or templates requires permission. Read the license.