Ambient background

Backgrounds

Adds a quiet animated composition around content, with decorative shapes kept behind a readable surface.

React · copy into your project · light and dark themes

Try it

Variant

Composition

A little space to begin.

A quiet setting for a welcome, an introduction, or the start of something new.

Take it at your own pace.

Loading preview…

Take it with you

Copy the example, API and usage notes for your editor or AI assistant.

Add to your project

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/ambient-background.json

The command includes the component’s shared dependencies. Your project keeps editable source files.

Include the complete example

This example also composes button, label, native-select, typography. Install its parts together:

Terminal

npx shadcn@latest add https://luv-jeri.github.io/cojeev-ui/r/ambient-background.json https://luv-jeri.github.io/cojeev-ui/r/button.json https://luv-jeri.github.io/cojeev-ui/r/label.json https://luv-jeri.github.io/cojeev-ui/r/native-select.json https://luv-jeri.github.io/cojeev-ui/r/typography.json

Using ambient background

Choose drift, orbit, or contour for a welcome section, introduction, or decorative pause between sections.
Pass children for foreground content and control paused when the surrounding experience should stop the decoration.

API

Compose the exported parts below. The prop types are read from the React source during the registry build.

Native element or underlying primitive props are inherited where declared, including accessible labels, event handlers and refs.

AmbientBackgroundProps

Prop	Type	Required
`variant`	`"drift" \| "orbit" \| "contour" \| null \| undefined`	No
`paused`	`boolean`	No

Accessibility

Decoration is hidden and inert; foreground children keep their own semantics.
Global motion Off and reduced-motion preferences produce a static composition; offscreen or hidden content pauses its animation.

States and appearance

runningpausedstatic

For conditional content, keep a MotionPresence boundary around keyed MotionSurface children. The shared entrance and exit states work with native primitives and respect your motion preference.

Try pointer and keyboard interaction, and switch the appearance control in the navigation to compare light and dark mode. Motion respects reduced motion preferences.