Skip to content
GaudiGaudi Design System home

Search documentation

Search every page, heading and paragraph.

GridScan

A perspective grid corridor illuminated by a traveling scan pulse.

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

Usage

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

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.
  • Four gridded planes converge into a tunnel. The scan pulse travels through its depth; pointer movement changes the vanishing point. Colors use the first entry for grid lines and the second for the scan.
  • Visual idea inspired by GridScan from React Bits (MIT + Commons Clause). Independently implemented for Gaudi; no React Bits source, shaders or assets are included.
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.