Skip to content
VenusUI
Get started

Particle Wave Hero

A centered hero over a rolling 3D particle wave.

Preview

Installation

npx shadcn@latest add @venusui/hero-07

Run this in a project set up with shadcn. If you haven’t set it up yet, run npx shadcn@latest init first.

Files added to your project

Paths use the default shadcn aliases. The CLI follows the aliases in your components.json.

  • @/hooks/use-scene-state.tsfrom use-scene-state
  • @/components/ui/particle-wave.tsxfrom particle-wave
  • @/components/hero-07.tsx

Also adds the shadcn button component if your project doesn't have it yet.

Usage

The code behind the preview above.

hero-07-demo.tsx

import { Hero07 } from "@/components/hero-07"

export default function Hero07Demo() {
  return <Hero07 />
}

API reference

No props. Edit the content directly in the file.

Requirements

  • shadcn button and VenusUI particle-wave (three.js). The CLI installs them, including @types/three.
  • A browser with WebGL; without it the text and actions still show.

Customization

  • The wave sits in the bottom 20rem; change h-80 to make it taller.
  • A muted wave color keeps the headline readable.

Accessibility

  • One h1. The wave is a labelled image that pauses off screen and with reduced motion.

Troubleshooting

Something looks different from the preview.
Blocks use your project’s theme and your own shadcn components, so they follow your styles.
Unknown registry "@venusui"
Your shadcn CLI couldn’t find the namespace in the shadcn registry index. Use the latest CLI (npx shadcn@latest), install by URL, or register it with its address: npx shadcn@latest registry add @venusui=https://venusui.com/r/{name}.json.
No components.json found
Run npx shadcn@latest init in your project first.