# Soap Bubble Hero

> Airy centered hero with drifting soap bubbles shaded by real thin-film interference: film thickness drains and swirls, so gold and magenta bands slide around and the crown thins to black. Bubbles show front and back films with window reflections, shy away from the cursor and pop into droplets on click. Raw WebGL, no three.js.

- Slug: `soap-bubble-hero`
- Category: [Heroes](https://www.assembli.design/category/heroes.md)
- Type: block
- Tags: 3d, webgl, shader, bubbles, iridescent, playful, interactive
- npm dependencies: motion, lucide-react
- shadcn/ui dependencies: button
- Added: 2026-10-15
- Live preview: https://www.assembli.design/preview/soap-bubble-hero
- Page: https://www.assembli.design/components/soap-bubble-hero

## Install

One-time setup (needs a subscription):

1. Add the registry to the project's `components.json`: `{"@assembli":{"url":"https://www.assembli.design/r/{name}.json","headers":{"Authorization":"Bearer ${ASSEMBLI_API_KEY}"}}}` (merge into `"registries"`).
2. Put an API key from https://www.assembli.design/account in `.env.local` as `ASSEMBLI_API_KEY=asm_…`.

Then install with the shadcn CLI (writes `components/soap-bubble-hero/soap-bubble-hero.tsx` and installs dependencies):

```bash
npx shadcn@latest add @assembli/soap-bubble-hero
```

Registry item JSON: https://www.assembli.design/r/soap-bubble-hero.json (send `Authorization: Bearer <api key>`)

## Code

> Component source needs an Assembli subscription ($12/month) and an API key sent as `Authorization: Bearer <key>`. To get one without copying anything, POST https://www.assembli.design/api/agent/login (or call the MCP tool connect_account), show the user the link it returns, and poll https://www.assembli.design/api/agent/token for the key. Or subscribe at https://www.assembli.design/pricing and create a key at https://www.assembli.design/account.