# Vanta.js — card for AI agents

Animated 3D website backgrounds (waves, birds, fog, net, globe, clouds) in a few lines; customize on the site and copy the snippet.

Category: Video references and motion backgrounds (also: Web animation examples and effects, Backgrounds, patterns and shapes) · maker Teng Bao · checked 2026-11-05 · style: abstract, 3d, gradient

## Price
- Price: Free
- Free tier: Fully free.

## License
MIT — https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md

- commercial: **yes** (Commercial use OK)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md)
- attribution: **no** (No credit needed)
  > The above copyright notice and this permission notice shall be included in all
  (https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md)
- in app: **yes** (Can ship inside your app)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md)
- redistribute: **yes** (Can pass the files on to your own users)
  > to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  (https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md)

## Rules to follow
- Keep the MIT notice if you redistribute the code.
- Pin three.js/p5 versions that the effect expects.

## Can an AI agent use it by itself?
**Yes** · package: Agent installs a package or loads it from a CDN

## How an agent gets files
- Customize an effect on vantajs.com and copy the code, or npm install vanta three (pin versions). (sign-in: none)
- Formats: js, html
- Not allowed: Needs three.js (or p5 for some effects)

## How to connect
- Package (npm/PyPI)
- npm: `npm install vanta`
- Repository: https://github.com/tengbao/vanta
- Website: https://www.vantajs.com

## Notes
The site snippet uses 'vanta@latest' from a CDN and an old three.js r121/r134: pin versions instead. npm vanta 0.5.24.

## Numbers (AgentGid data)
- Gid Score: 32
- GitHub stars: 7,385
- Downloads last week: 47,299
- Used in 2 public projects set up for AI coding agents

## Lines to paste into your prompt or AGENTS.md

```
- Vanta.js (Video references and motion backgrounds, Web animation examples and effects, Backgrounds, patterns and shapes). Animated 3D website backgrounds (waves, birds, fog, net, globe, clouds) in a few lines; customize on the site and copy the snippet. Price: free; commercial use OK; no credit needed. Style: abstract, 3d, gradient.
  Connect: npm vanta.
  Get files: Customize an effect on vantajs.com and copy the code, or npm install vanta three (pin versions) (js, html).
  Not allowed: Needs three.js (or p5 for some effects)
  Rule: Keep the MIT notice if you redistribute the code.
  Rule: Pin three.js/p5 versions that the effect expects.
  License: https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md (checked 2026-11-05; details: https://agentgid.com/assets/vanta-js/)
```

## Links
- AgentGid page: https://agentgid.com/assets/vanta-js/
- Is it free for commercial use? https://agentgid.com/assets/vanta-js/commercial-use/
- Source: https://www.vantajs.com/
- Source: https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md
- Source: https://registry.npmjs.org/vanta/latest


## Vanta.js: moving 3D backgrounds for a web page

Vanta.js puts a moving 3D picture, like waves, fog, a net of lines or flying birds, behind any block of a web page. You or your AI assistant add a few lines of code and pick colors to match your brand. It is free under the MIT license, also for paid products.

### Where to use it
- Hero section behind a headline: Put moving waves or fog behind the big title at the top of a landing page. The text stays in front and readable, and the effect fills the block.
- Background for a React page: In a React app the effect starts when the block appears and is removed when the person leaves the page, so it does not keep running in the background.
- Match colors to your brand: Change the effect's colors after it starts, for example when the person switches to dark mode, without reloading the page.
- Lighter than a background video: Use it instead of a large looping video or image behind a section; the moving picture is drawn by the browser at full sharpness.
- Website builder custom code: On a site builder that lets you paste code into the page footer, copy the snippet from the Vanta site and point it at your section.
- Event or product launch page: Give a one-off launch or event page a moving net or halo in your event colors behind the date and the sign-up button. (idea, not from the official pages)

### How to start
- Pick an effect and colors on the Vanta site, or start from the README; load three.js first, then the effect file.

```
<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r134/three.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/vanta/dist/vanta.waves.min.js"></script>
<script>
  VANTA.WAVES('#my-background')
</script>
```

- Point it at your block with options; the canvas takes the block's width and height.

```
VANTA.WAVES({
  el: '#my-background', // element selector string or DOM object reference
  color: 0x000000,
  waveHeight: 20,
  shininess: 50,
  waveSpeed: 1.5,
  zoom: 0.75
})
```

- In a bundled app, install the package and import one effect file.

```
npm i vanta
```


### License
Free for personal and paid sites and apps, with no visible credit needed. Keep the MIT copyright and permission notice in copies of the code.

### Good to know
- The site advises at most one or two effects per page, because some are slow on older computers.
- Not every effect works on phones, so set a plain background image or color behind it as a fallback.
- It needs three.js loaded first; a few effects, such as Trunk, use the p5.js drawing library instead.
- The last package release, 0.5.24, came out in September 2022, so pin it and the three.js version it was built for.
- Some effects are adapted from other people's published examples and shaders, credited in the README; check those originals before shipping the clouds effects in a paid product.

Checked 2026-11-10 against: https://www.vantajs.com/, https://raw.githubusercontent.com/tengbao/vanta/master/README.md, https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md, https://registry.npmjs.org/vanta/latest, https://registry.npmjs.org/vanta, https://registry.npmjs.org/vanta/0.5.24, https://registry.npmjs.org/three/0.134.0

### Mistakes to avoid
- Don't: <script src="https://cdn.jsdelivr.net/npm/vanta@latest/dist/vanta.waves.min.js"> with three r121 as in the site snippet → Do: Install vanta 0.5.24 and three 0.134.0 (the version the README loads) or host those exact files yourself (@latest moves without notice; the README itself loads three r134.)
- Don't: import BIRDS from 'vanta/dist/vanta.birds.min' with no THREE anywhere on the page → Do: Pass THREE in the options (BIRDS({ el, THREE })) or load three.min.js in a script tag first (The effect files expect a THREE object; the README says to make sure window.THREE is defined.)
- Don't: Starting the effect in a React component and never calling destroy() → Do: Keep the returned effect and call effect.destroy() when the component unmounts (Each effect keeps its own drawing loop running until it is destroyed.)
- Don't: Three or more Vanta effects on one page → Do: One effect per page, maybe two, with a plain color fallback (The site warns that WebGL effects are slow on older computers.)
- Don't: Resizing the block and expecting the canvas to follow → Do: Call effect.resize() after the container changes size (The README gives resize() for redrawing at a new size.)

### Questions
- Can I use Vanta.js on a client's paid website? Yes. The MIT license allows use, changes and sale; keep the license notice in copies of the code.
- Can I put text and buttons on top of the effect? Yes. Other content inside the same block shows in front of the moving picture.
- Does it react to the mouse? Some effects follow the mouse or touch by default; turn this off with mouseControls and touchControls set to false.
- Will it work on phones? Not every effect does; the site advises a background image or color as a fallback.
- Does it work with React or Vue? Yes. The README shows React and Vue examples that import one effect file and destroy it on unmount.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
