OPUS/UI

Navigation

Topography

Animated contour map with anti-aliased isolines (via fwidth) and bolder index contours. The pointer raises a hill; clicking drops a ring of terrain that spreads outward.

webglpointerclicklines6 files · 630 locdeps: clsx, tailwind-merge

Installation

With the shadcn CLI, pointing at this platform’s registry:

npx shadcn@latest add https://opusui.131199999.xyz/r/topography.json

Or offline, straight from your opus55 checkout (copies every file it needs):

node ../tailwind_component/opus55/scripts/add.mjs topography

Usage

import { Topography } from "@/components/opus/backgrounds/topography";

<Topography className="absolute inset-0" />

API

PropTypeDefaultDescription
lineColor / accentstring—Regular contour and every-5th index contour colours.
backgroundstring—Map colour.
densitynumber14Contours per unit height.
thicknessnumber1.2Line weight (px).
hillnumber1.2Height of the pointer hill.
speednumber1Time multiplier. 0 freezes the animation; the pointer stays live.
interactivebooleantrueReact to the pointer (tracked on window, so overlaid content never blocks it).
classNamestring—Classes for the wrapper. Use `absolute inset-0` to fill a relative parent.
childrenReactNode—Optional content rendered above the canvas.

Notes

  • Renders with WebGL2 into a single full-screen triangle — no three.js, no textures, no dependencies.
  • Pauses automatically when scrolled off-screen or when the tab is hidden; resumes on return.
  • prefers-reduced-motion: reduce renders one still frame and ignores the pointer.
  • A CSS gradient fallback paints instantly and stays if WebGL2 is unavailable.

Command palette