Topo Background - React Component | Kokonut UI

Topo Background

A living contour map that drifts, rises under the cursor and ripples on click, built with React and Canvas.

Installation

Topo Background is a free, open-source React component in the Kokonut UI Backgrounds collection. Add it with the shadcn CLI, which copies the source into components/kokonutui/topo-background.tsx, so the code is yours to change.

npx shadcn@latest add @kokonutui/topo-background

Usage

import TopoBackground from "@/components/kokonutui/topo-background";

export default function Example() {
  return <TopoBackground />;
}

Props

Dependencies

Needs Version Comes from
cn from lib/utils.ts shadcn init
React 19 Your app
Tailwind CSS 4 Your app

No provider, font or global CSS to set up: the file works as soon as it lands.

[Wind](/content/docs/backgrounds/flow-field/index.html)

Streamlines that part around the cursor, swirl in its wake and scatter on click, built with React and Canvas.

[Drape Background](/content/docs/backgrounds/drape-background/index.html)

A pleated curtain in a breeze that you can push and pull, built with React, WebGL and a cloth simulation.