Hero Templates

Penumbra

A cloud of dark shards hangs between a spotlight and a wall, beside left-aligned copy. From most angles its shadow looks like noise. Turn the cloud to its true angle and the shadow spells a word. Let go and it turns back.

Install

bun add three

Then copy 2 files into your project:

  • components/registry/penumbra/penumbra.tsx
  • hooks/use-animation-loop.ts

Props

PropTypeDefaultDescription
shardCount"400" | "800" | "1600""800"How many shards, in fixed steps. More shards draw a sharper word. Each step rebuilds the cloud.
lightColorstring (hex)"#f3eeff"Spotlight color, and the pool of light it throws on the wall.
rimColorstring (hex)"#a855f7"Edge light on the shards.
shardColorstring (hex)"#17141f"Base color of the shards.
wallColorstring (hex)"#77728a"Color of the back wall.
shardSizenumber1Shard size. Small shards leave gaps in the letters.
scatternumber0.6How far the shards spread along the light. More spread looks more random from the side.
softnessnumber0.35How soft the shadow's edge is. 0 is a hard edge.
lightIntensitynumber1.2Spotlight strength.
hazenumber0.35Dust in the light beam. 0 hides the beam.
driftnumber0.5How far the shards float while idle. They float along the light, so the word holds.
snapBackbooleantrueTurn back to the true angle after you let go.
parallaxbooleantrueThe camera leans toward the pointer, easing back on leave.

What It Demonstrates

Loop
An animation that repeats, a set number of times or infinitely.
Drag
Moving an element by grabbing it, often with momentum when released.
Momentum
Motion that carries velocity, especially after a drag or interruption.
Spring
Motion driven by physics (tension, mass, damping) rather than a set duration.
Reveal
Content is uncovered gradually, often by animating a clip-path or mask.
Float
A gentle, continuous up-and-down drift that makes a static element feel alive and weightless.
Hardware acceleration
Animating transform and opacity lets the GPU keep motion smooth.

Related Components

Appears In