Skip to content

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

3.4 KB
Raw Blame
---
title: Paper Wobble
description: Per-pose reshoot jitter that makes any content feel hand-placed on a desk
component: paper-wobble
vibe: paper
length: 90
useWhen:
  - "Any block should carry the stop-motion reshoot wobble — headlines, cards, or content that must feel hand-placed rather than laid out."
  - "Two or more elements should read as separate objects on a desk: give each its own `seed`."
avoidWhen:
  - "The content should sit rock-still — UI simulations, code blocks being read."
  - "You want smooth floating motion rather than discrete poses — use `drift`."
  - "The component already jitters itself, like `paper-sticker`; wrapping it just doubles the shake."
askedAs:
  - "stop motion jitter"
  - "hand placed wobble"
  - "I want any card or headline to jitter like stop motion on a desk"
  - "handmade reshoot feel for content"
  - "subtle frame-by-frame shake that looks hand-placed"
  - "viewer feels the scene was animated with paper by hand"
---

<ComponentPreview name="paper-wobble" />

<InstallBlock name="paper-wobble" />

## Usage

Wrap anything. The wrapper holds one offset for a whole stop-motion pose, then
snaps to the next — the wobble of a photo that was picked up and put back down.

```tsx
// src/Root.tsx
import { AbsoluteFill, Composition } from "remotion";
import { PaperWobble } from "@/components/remocn/paper-wobble";

const PaperWobbleScene = () => (
  <AbsoluteFill
    style={{
      background: "#f1eee7",
      alignItems: "center",
      justifyContent: "center",
      flexDirection: "column",
      gap: 40,
    }}
  >
    <PaperWobble seed="title">
      <h1 style={{ fontSize: 64, color: "#26242c" }}>Shot on a desk</h1>
    </PaperWobble>
    <PaperWobble seed="card">
      <YourCard />
    </PaperWobble>
  </AbsoluteFill>
);

export const RemotionRoot = () => (
  <Composition
    id="PaperWobble"
    component={PaperWobbleScene}
    durationInFrames={90}
    fps={30}
    width={1280}
    height={720}
  />
);
```

Give each wrapped block its own `seed` — two instances sharing a seed move in
lockstep, which reads as one rigid sheet rather than two objects on a desk.

Components that already carry their own jitter, like `paper-sticker`, do not
need this wrapper — doubling it up just doubles the shake.

The wrapper is `display: inline-block` and nothing else: no size, no
background, no positioning. If you pass a `transform` through `style`, it is
applied first and the jitter is appended, so your own positioning survives.

<PropsTable title="Props"
  rows={[
    {
      name: "children",
      type: "React.ReactNode",
      required: true,
      description: "The content to wobble",
    },
    {
      name: "seed",
      type: "string",
      default: "\"wobble\"",
      description: "Seed for the jitter — same seed, same motion",
    },
    {
      name: "amp",
      type: "number",
      default: "1.4",
      description: "Maximum offset in pixels on each axis",
    },
    {
      name: "rotAmp",
      type: "number",
      default: "0.35",
      description: "Maximum rotation in degrees",
    },
    {
      name: "step",
      type: "number",
      default: "3",
      description: "Frames per stop-motion pose — the tempo control",
    },
    {
      name: "className",
      type: "string",
      description: "Passed through to the wrapper div",
    },
    {
      name: "style",
      type: "React.CSSProperties",
      description: "Merged over the defaults; a transform here is composed before the jitter",
    },
  ]}
/>