Particle Sea

A rolling sea of fine points seen in perspective; crests catch the light and glitter.

AnimationsBackgrounds@gaudi/design-system/animations/ParticleSeaView in Storybook Source

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 { ParticleSea } from '@gaudi/design-system/animations/ParticleSea';

Usage

import { ParticleSea } from '@gaudi/design-system/animations/ParticleSea';
<ParticleSea height={500} waveHeight={1.2} colors={['var(--ds-color-warning)']} />

Examples

Playground

Storybook

API

13 props

Accessibility

The canvas is decorative and hidden from assistive technology. Keep important content in children and provide a pause control for continuous animation. Reduced motion renders a static frame; unsupported WebGL retains the styled container and content.

Notes

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.
Points are spaced evenly across the water, so they shrink and crowd towards the horizon. Only crests are lit, and each point twinkles on its own phase. Points too small to resolve fade out instead of shimmering.

AeroShardsFaceted shards flow through a curved stream in layers of depth. Hold the pointer to gather the stream, then release to unfurl it.AuroraTheme-aware Aurora light curtains, with a Soft Aurora variant that forms a narrow glowing ribbon.CRTWarpCoarse phosphor cells form evolving plasma shapes beneath fine scanlines, analog grain, and local pointer distortion.DarkVeilBroad illuminated folds drift across a dark surface, with sharp creases and deep intervening shadows.DitherFlowing waves rendered with ordered dithering and a limited tonal palette.FaultyTerminalA curved phosphor display of changing pixel glyphs, scanlines and intermittent signal faults.