# Dot Field

A halftone dot membrane that ripples behind a swipe and rings out from a click, built with React and Canvas.

Install with Agentbunn npm

```bash
npx shadcn@latest add https://kokonutui.com/r/dot-field.json
```

## Leave a mark

A halftone membrane. Swipe fast to leave a wake, click to send a shockwave through it.

## Installation

Dot Field is a free, open-source React component in the Kokonut UI [Backgrounds collection](/content/docs/backgrounds/index.html). Add it with the shadcn CLI, which copies the source into `components/kokonutui/dot-field.tsx`, so the code is yours to change.

```bash
npx shadcn@latest add @kokonutui/dot-field
```

## Usage

```javascript
import DotField from "@/components/kokonutui/dot-field";

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

## Props

`className`

`string`

Extra classes for the root element.

`children`

`ReactNode`

Content shown over the field. Pass `null` for a bare background.

`spacing`

`number`

Default `16`

Distance between dots, in px.

`interactive`

`boolean`

Default `true`

Let a swipe push the dots and a click send a shockwave.

`seed`

`number`

Default `7`

Seed for the halftone pattern, so a page always opens on the same one.

## 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.
