Skip to content

Production-ready animations, transitions, backgrounds, and scenes for Remotion

feat: gooey morph

kapishdimaac6ad096a538
diff --git a/content/docs/typography/gooey-morph.mdx b/content/docs/typography/gooey-morph.mdx
new file mode 100644
index 00000000..32144994
--- /dev/null
+++ b/content/docs/typography/gooey-morph.mdx
@@ -0,0 +1,185 @@
+---
+title: Gooey Morph
+description: Bars fly in Tetris-style, land as a row, and melt into a word through a gooey blur-and-threshold morph
+component: gooey-morph
+vibe: playful
+length: 76
+useWhen:
+ - "A title reveal should feel liquid and organic — shapes fuse and hand their mass to the word instead of crossfading."
+ - "You want a two-act entrance with a built-in rhythm: a kinetic build (bars flying in off-beat) and a payoff (the melt)."
+ - "The word is short and set in a heavy display face — the goo needs solid masses to fuse."
+ - "Everything that should fuse can live inside this one component — the morph only affects its own SVG group."
+avoidWhen:
+ - "You need a plain text entrance without the shape build-up — use `soft-blur-in` or `mask-reveal-up`."
+ - "The text is long or thin-stroked — the blur-threshold eats thin strokes and long words don't match the four-bar row."
+ - "The style is crisp and geometric rather than liquid — use `kinetic-center-build`."
+---
+
+<ComponentPreview name="gooey-morph" />
+
+## Installation
+
+<InstallBlock name="gooey-morph" />
+
+## Usage
+
+```tsx
+// src/Root.tsx
+import { Composition } from "remotion";
+import { GooeyMorph } from "@/components/remocn/gooey-morph";
+
+const GooeyMorphScene = () => (
+ <GooeyMorph word="HELLO" fontFamily="'Bodoni Moda', Georgia, serif" />
+);
+
+export const RemotionRoot = () => (
+ <Composition
+ id="GooeyMorph"
+ component={GooeyMorphScene}
+ durationInFrames={120}
+ fps={30}
+ width={1920}
+ height={1080}
+ />
+);
+```
+
+The melt works by blurring the alpha channel and pushing it through a
+near-vertical threshold: where two shapes sit close, their blurred edges add up,
+cross the threshold, and paint a solid neck between them. Everything that
+should fuse lives inside the component's single filtered group — nearby
+elements outside it never join the goo.
+
+## Props
+
+<PropsTable
+ rows={[
+ {
+ name: "word",
+ type: "string",
+ default: "\"HELLO\"",
+ description: "The word the bars melt into",
+ },
+ {
+ name: "fill",
+ type: "string",
+ default: "\"#ffffff\"",
+ description: "Fill color of the bars and the word",
+ },
+ {
+ name: "fontFamily",
+ type: "string",
+ default: "\"sans-serif\"",
+ description: "Font family of the word — heavy display faces melt best",
+ },
+ {
+ name: "fontSize",
+ type: "number",
+ default: "237",
+ description: "Font size in comp pixels",
+ },
+ {
+ name: "tracking",
+ type: "number",
+ default: "0",
+ description: "Letter spacing of the word",
+ },
+ {
+ name: "wordCenterX / wordBaselineY",
+ type: "number",
+ default: "961.4 / 601.3",
+ description: "Horizontal center and baseline of the word in comp pixels",
+ },
+ {
+ name: "width / height",
+ type: "number",
+ default: "1920 / 1080",
+ description: "Coordinate space of the composition",
+ },
+ {
+ name: "barWidth / barHeight",
+ type: "number",
+ default: "213 / 181",
+ description: "Size of each bar in comp pixels",
+ },
+ {
+ name: "barStartPositions",
+ type: "[number, number][]",
+ default: "4 scattered points",
+ description: "Where each bar starts, as `[x, y]` centers",
+ },
+ {
+ name: "barRestPositions",
+ type: "[number, number][]",
+ default: "4 points in a row",
+ description: "Where each bar lands before the melt",
+ },
+ {
+ name: "barEntryFrames",
+ type: "number[]",
+ default: "[8, 0, 4, 13]",
+ description: "Per-bar entry frames — deliberately non-monotonic so the build reads as Tetris, not a wave",
+ },
+ {
+ name: "barTravelFrames",
+ type: "number",
+ default: "30",
+ description: "Length of one bar's L-shaped move: horizontal into the column, then vertical into the row",
+ },
+ {
+ name: "morphStartFrame / morphPeakFrame / morphEndFrame",
+ type: "number",
+ default: "50 / 63 / 76",
+ description: "The melt window. Blur and displacement are zero outside it",
+ },
+ {
+ name: "blurRadius",
+ type: "number",
+ default: "6",
+ description: "Peak goo blur radius",
+ },
+ {
+ name: "blurIterations",
+ type: "number",
+ default: "6",
+ description: "Box blur passes folded into the equivalent Gaussian sigma",
+ },
+ {
+ name: "alphaInputBlack / alphaInputWhite",
+ type: "number",
+ default: "0.4588 / 0.5098",
+ description: "Alpha threshold range — the narrower, the harder the goo edge",
+ },
+ {
+ name: "displaceAmount",
+ type: "number",
+ default: "20",
+ description: "Peak turbulent displacement of the goo edge, in pixels",
+ },
+ {
+ name: "displaceSize",
+ type: "number",
+ default: "19",
+ description: "Feature size of the displacement noise",
+ },
+ {
+ name: "displaceComplexity",
+ type: "number",
+ default: "1",
+ description: "Noise octaves",
+ },
+ {
+ name: "displaceEvolutionPerSecond",
+ type: "number",
+ default: "50",
+ description: "How fast the noise field pans, per second",
+ },
+ {
+ name: "className",
+ type: "string",
+ description: "Optional className passed to the wrapper",
+ },
+ ]}
+/>
+
+Inspired by [5 Clean Text Animations](https://www.youtube.com/watch?v=Nmi7cE2wT54) by Mapal.
diff --git a/content/docs/typography/meta.json b/content/docs/typography/meta.json
index 6b492e86..5cc42124 100644
--- a/content/docs/typography/meta.json
+++ b/content/docs/typography/meta.json
@@ -40,6 +40,7 @@
"infinite-marquee",
"perspective-marquee",
"matrix-decode",
- "rgb-glitch-text"
+ "rgb-glitch-text",
+ "gooey-morph"
]
}
diff --git a/registry/__index__.tsx b/registry/__index__.tsx
index 5cea5a01..de5579b1 100644
--- a/registry/__index__.tsx
+++ b/registry/__index__.tsx
@@ -308,6 +308,16 @@ const registry: Record<string, RegistryEntry> = {
(m) => m.matrixDecodeConfig,
),
},
+ "gooey-morph": {
+ load: () =>
+ import("@/registry/remocn/gooey-morph").then((m) => ({
+ default: m.GooeyMorph,
+ })),
+ loadConfig: () =>
+ import("@/registry/remocn/gooey-morph/config").then(
+ (m) => m.gooeyMorphConfig,
+ ),
+ },
"kinetic-warp": {
load: () =>
import("@/registry/remocn/kinetic-warp").then((m) => ({
diff --git a/registry/remocn/gooey-morph/config.ts b/registry/remocn/gooey-morph/config.ts
new file mode 100644
index 00000000..a3849ced
--- /dev/null
+++ b/registry/remocn/gooey-morph/config.ts
@@ -0,0 +1,44 @@
+import { type ComponentConfig, FPS, H, W } from "@/lib/customizer-config";
+
+export const gooeyMorphConfig: ComponentConfig = {
+ componentName: "GooeyMorph",
+ importPath: "@/components/remocn/gooey-morph",
+ controls: {
+ word: { type: "text", default: "HELLO", label: "Word" },
+ fill: { type: "color", default: "#f2f2f2", label: "Fill" },
+ fontFamily: {
+ type: "text",
+ default: "'Bodoni Moda', Georgia, serif",
+ label: "Font family",
+ },
+ blurRadius: {
+ type: "number",
+ default: 6,
+ min: 0,
+ max: 20,
+ step: 1,
+ label: "Goo blur radius",
+ },
+ displaceAmount: {
+ type: "number",
+ default: 20,
+ min: 0,
+ max: 80,
+ step: 1,
+ label: "Displace amount",
+ },
+ barTravelFrames: {
+ type: "number",
+ default: 30,
+ min: 10,
+ max: 60,
+ step: 1,
+ label: "Bar travel (frames)",
+ },
+ },
+ durationInFrames: 120,
+ fps: FPS,
+ compositionWidth: W,
+ compositionHeight: H,
+ previewBackdrop: { type: "color", value: "#141318" },
+};
diff --git a/registry/remocn/gooey-morph/index.tsx b/registry/remocn/gooey-morph/index.tsx
new file mode 100644
index 00000000..ecda2a2e
--- /dev/null
+++ b/registry/remocn/gooey-morph/index.tsx
@@ -0,0 +1,252 @@
+"use client";
+
+import { useId } from "react";
+import { Easing, interpolate, useCurrentFrame } from "remotion";
+
+export interface GooeyMorphProps {
+ className?: string;
+ width?: number;
+ height?: number;
+ barWidth?: number;
+ barHeight?: number;
+ barStartPositions?: [number, number][];
+ barRestPositions?: [number, number][];
+ barEntryFrames?: number[];
+ barTravelFrames?: number;
+ word?: string;
+ fontFamily?: string;
+ fontSize?: number;
+ tracking?: number;
+ wordCenterX?: number;
+ wordBaselineY?: number;
+ blurRadius?: number;
+ blurIterations?: number;
+ alphaInputBlack?: number;
+ alphaInputWhite?: number;
+ morphStartFrame?: number;
+ morphPeakFrame?: number;
+ morphEndFrame?: number;
+ displaceAmount?: number;
+ displaceSize?: number;
+ displaceComplexity?: number;
+ displaceEvolutionPerSecond?: number;
+ fill?: string;
+}
+
+function boxBlurSigma(radius: number, iterations: number): number {
+ const w = 2 * radius + 1;
+ return Math.sqrt((iterations * (w * w - 1)) / 12);
+}
+
+export function GooeyMorph({
+ className,
+ width = 1920,
+ height = 1080,
+ barWidth = 213,
+ barHeight = 181,
+ barStartPositions = [
+ [956.9, 764.9],
+ [297.5, 799.9],
+ [738.2, 257.9],
+ [1617.9, 302.9],
+ ],
+ barRestPositions = [
+ [634.9, 538.9],
+ [852.5, 538.9],
+ [1070.2, 538.9],
+ [1287.9, 538.9],
+ ],
+ barEntryFrames = [8, 0, 4, 13],
+ barTravelFrames = 30,
+ word = "HELLO",
+ fontFamily = "sans-serif",
+ fontSize = 237,
+ tracking = 0,
+ wordCenterX = 961.4,
+ wordBaselineY = 601.3,
+ blurRadius = 6,
+ blurIterations = 6,
+ alphaInputBlack = 0.4588,
+ alphaInputWhite = 0.5098,
+ morphStartFrame = 50,
+ morphPeakFrame = 63,
+ morphEndFrame = 76,
+ displaceAmount = 20,
+ displaceSize = 19,
+ displaceComplexity = 1,
+ displaceEvolutionPerSecond = 50,
+ fill = "#ffffff",
+}: GooeyMorphProps) {
+ const frame = useCurrentFrame();
+ const filterId = useId();
+
+ const travelEase = Easing.bezier(0.88, 0.14, 0.12, 0.86);
+
+ const morphWindow: [number, number, number] = [
+ morphStartFrame,
+ morphPeakFrame,
+ morphEndFrame,
+ ];
+
+ const blur = interpolate(frame, morphWindow, [0, blurRadius, 0], {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ easing: Easing.bezier(0.33, 0, 0.67, 1),
+ });
+ const sigma = boxBlurSigma(blur, blurIterations);
+
+ const displaceScale = interpolate(
+ frame,
+ morphWindow,
+ [0, displaceAmount, 0],
+ {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ easing: Easing.bezier(0.33, 0, 0.67, 1),
+ },
+ );
+
+ const barsOpacity = interpolate(
+ frame,
+ [morphStartFrame, morphEndFrame],
+ [1, 0],
+ {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ },
+ );
+ const wordOpacity = interpolate(
+ frame,
+ [morphStartFrame, morphEndFrame],
+ [0, 1],
+ {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ },
+ );
+
+ const slope = 1 / Math.max(alphaInputWhite - alphaInputBlack, 1e-6);
+ const offset = -alphaInputBlack * slope;
+
+ const evolution = (frame / 30) * displaceEvolutionPerSecond;
+
+ return (
+ <div
+ className={className}
+ style={{ position: "absolute", inset: 0, overflow: "hidden" }}
+ >
+ <svg
+ width="100%"
+ height="100%"
+ viewBox={`0 0 ${width} ${height}`}
+ preserveAspectRatio="xMidYMid meet"
+ style={{ display: "block" }}
+ >
+ <defs>
+ <filter
+ id={filterId}
+ x="-15%"
+ y="-15%"
+ width="130%"
+ height="130%"
+ colorInterpolationFilters="sRGB"
+ >
+ <feGaussianBlur
+ in="SourceGraphic"
+ stdDeviation={sigma}
+ result="blurred"
+ />
+ <feColorMatrix
+ in="blurred"
+ type="matrix"
+ values={[
+ "1 0 0 0 0",
+ "0 1 0 0 0",
+ "0 0 1 0 0",
+ `0 0 0 ${slope} ${offset}`,
+ ].join(" ")}
+ result="threshold"
+ />
+ <feTurbulence
+ type="fractalNoise"
+ baseFrequency={1 / Math.max(displaceSize, 1)}
+ numOctaves={Math.max(1, Math.round(displaceComplexity))}
+ seed={7}
+ result="noise"
+ />
+ <feOffset
+ in="noise"
+ dx={evolution}
+ dy={evolution * 0.6}
+ result="noiseMoved"
+ />
+ <feDisplacementMap
+ in="threshold"
+ in2="noiseMoved"
+ scale={displaceScale}
+ xChannelSelector="R"
+ yChannelSelector="G"
+ />
+ </filter>
+ </defs>
+
+ <g filter={`url(#${filterId})`}>
+ <g opacity={barsOpacity}>
+ {barRestPositions.map((rest, i) => {
+ const start = barStartPositions[i] ?? rest;
+ const entry = barEntryFrames[i] ?? 0;
+ const local = frame - entry;
+ const stops = [0, barTravelFrames / 2, barTravelFrames];
+
+ const x = interpolate(
+ local,
+ stops,
+ [start[0], rest[0], rest[0]],
+ {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ easing: travelEase,
+ },
+ );
+ const y = interpolate(
+ local,
+ stops,
+ [start[1], start[1], rest[1]],
+ {
+ extrapolateLeft: "clamp",
+ extrapolateRight: "clamp",
+ easing: travelEase,
+ },
+ );
+
+ return (
+ <rect
+ key={rest.join(",")}
+ x={x - barWidth / 2}
+ y={y - barHeight / 2}
+ width={barWidth}
+ height={barHeight}
+ fill={fill}
+ />
+ );
+ })}
+ </g>
+
+ <text
+ x={wordCenterX}
+ y={wordBaselineY}
+ textAnchor="middle"
+ fontFamily={fontFamily}
+ fontSize={fontSize}
+ fontWeight={900}
+ letterSpacing={tracking}
+ fill={fill}
+ opacity={wordOpacity}
+ >
+ {word}
+ </text>
+ </g>
+ </svg>
+ </div>
+ );
+}
diff --git a/registry/remocn/registry.json b/registry/remocn/registry.json
index febb676d..6b1d17cc 100644
--- a/registry/remocn/registry.json
+++ b/registry/remocn/registry.json
@@ -794,6 +794,20 @@
}
]
},
+ {
+ "name": "gooey-morph",
+ "type": "registry:component",
+ "title": "Gooey Morph",
+ "description": "Bars fly in Tetris-style, land as a row, and melt into a word through a gooey blur-and-threshold morph.",
+ "dependencies": ["remotion"],
+ "files": [
+ {
+ "path": "gooey-morph/index.tsx",
+ "type": "registry:component",
+ "target": "components/remocn/gooey-morph.tsx"
+ }
+ ]
+ },
{
"name": "grain-dissolve",
"type": "registry:component",