Skip to content
GaudiGaudi Design System home

Search documentation

Search every page, heading and paragraph.

ShapeWaves

Ten-pixel cells cycle through triangle, circle and square bands, with optional text carved out of the field.

AnimationsBackgrounds@gaudi/design-system/animations/ShapeWavesView in StorybookSource

Installation

pnpm add github:ahmadassaf/design-system

Import from @gaudi/design-system. Load @gaudi/design-system/global.css once and add transpilePackages: ['@gaudi/design-system'] in Next.js.

import { ShapeWaves } from '@gaudi/design-system/animations/ShapeWaves';

Usage

import { ShapeWaves } from '@gaudi/design-system/animations/ShapeWaves';
<ShapeWaves height={500} paused={paused} />

Examples

Playground

Storybook

API

14 props

Accessibility

The canvas is decorative and hidden from assistive technology. Foreground children remain readable and interactive. Provide a pause control for continuous motion, and place text on a contrasting surface. Reduced motion displays a still frame; unavailable WebGL uses a static color fallback.

Notes

  • The text cutout is empty by default. Set the text control to add your own cutout.
  • The playground layers a Gaudi header, hero and working documentation links above the effect. The Demo content switch hides only this foreground; canvas size, animation phase and pause state are retained.
  • Scale changes wave size while cellSize controls glyph density. Dark bands are triangles, middle bands circles and bright bands squares.
  • Visual idea inspired by ShapeWaves from React Bits. Independently implemented for Gaudi from the rendered visual reference; no React Bits source code, shaders or assets are included.