Magnetic Field Visualizer

<MagneticFieldVisualizer>CSS Modules

Dipole field lines with polarity and density controls.

InstallationColoxo CLI
npx coloxo add magnetic-field-visualizer
ES Module ImportPlayground / npm package
import { MagneticFieldVisualizer } from '@coloxo/ui/visuals';

1. Live preview

This is the real component, not a recording. Move the pointer over it, then adjust the renderer settings.

Fragment shader
<MagneticFieldVisualizer quality="low" />

2. Usage

Dipole field lines with polarity and density controls. npx coloxo add magnetic-field-visualizer copies this effect in a Tailwind project or a Coloxo CSS project, and adds @coloxo/ui to package.json. You can also import it from @coloxo/ui/visuals.

3. Performance notes

Effects render on demand and dispose their GPU context when unmounted.

  • Every effect pauses when scrolled out of view or when the tab is hidden, so an idle page costs nothing.
  • quality caps the device pixel ratio. Keep it at low when several effects share one viewport.
  • With respectReducedMotion enabled, the effect renders a single static frame instead of animating.
  • The output is a decorative canvas hidden from assistive technology. Never place essential content only inside the effect.

4. Props

NameTypeDefaultDescription
poleCount2 | 32Number of poles, 2–3.
fieldStrengthnumber0.6Field line curvature strength, 0–1.
lineDensitynumber4Contour density, 1–8.
particleSpeednumber0.5How fast the field advects, 0–1.
polarityMagneticPolarity`attract`Pole orientation.
colorModeMagneticColorMode`brand`Colour mapping for the field.
pausedbooleanfalseRender a single static frame instead of animating.
respectReducedMotionbooleantrueFreeze to a static frame when prefers-reduced-motion is set.
quality"low" | "medium" | "high"mediumCaps the renderer pixel ratio. Use low for grids of many effects.
className / stylestring / CSSProperties—Applied to the container element.