{
 "slug": "vanta-js",
 "name": "Vanta.js",
 "author": "Teng Bao",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Animated 3D website backgrounds (waves, birds, fog, net, globe, clouds) in a few lines; customize on the site and copy the snippet.",
 "category": {
  "slug": "video-backgrounds",
  "name": "Video references and motion backgrounds"
 },
 "tags": [
  "Code library",
  "Open source"
 ],
 "styles": [
  "abstract",
  "3d",
  "gradient"
 ],
 "logo_url": "https://agentgid.com/media/avatars/tengbao.png",
 "logo_letter": "V",
 "links": {
  "repo": "https://github.com/tengbao/vanta",
  "website": "https://www.vantajs.com",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/vanta-js/demo.jpg",
  "alt": "Waves behind a headline, a net of lines, soft fog, a glowing halo, cells and flying birds, each in its own colors and frozen at one moment.",
  "caption": "Made by AgentGid with vanta 0.5.24 and three 0.134.0 (npm). Vanta.js and three.js are under the MIT license, which allows showing their output; the picture was drawn by AgentGid with the packages, no files of the project are shown."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free.",
   "source": {
    "label": "vantajs.com",
    "url": "https://www.vantajs.com"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "MIT",
   "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
   "note": "MIT allows use in paid products; keep the notice in copies of the code.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "The above copyright notice and this permission notice shall be included in all",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "npm package",
   "status": "info",
   "sub": "Installs without a key",
   "quote": null,
   "note": "An agent can install it by itself with npm install vanta. No key or account is needed.",
   "source": {
    "label": "github.com/tengbao/vanta",
    "url": "https://github.com/tengbao/vanta"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "MIT",
  "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "Keep the MIT notice if you redistribute the code.",
   "Pin three.js/p5 versions that the effect expects."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "The above copyright notice and this permission notice shall be included in all",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "Allowed",
    "status": "yes",
    "quote": "to use, copy, modify, merge, publish, distribute, sublicense, and/or sell",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
    },
    "note": null
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-11-05",
  "commercial_use_page": "https://agentgid.com/assets/vanta-js/commercial-use/"
 },
 "overview": {
  "heading": "Vanta.js: moving 3D backgrounds for a web page",
  "body": "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."
 },
 "uses": [
  {
   "title": "Hero section behind a headline",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Background for a React page",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Match colors to your brand",
   "text": "Change the effect's colors after it starts, for example when the person switches to dark mode, without reloading the page.",
   "idea": false,
   "image": null
  },
  {
   "title": "Lighter than a background video",
   "text": "Use it instead of a large looping video or image behind a section; the moving picture is drawn by the browser at full sharpness.",
   "idea": false,
   "image": null
  },
  {
   "title": "Website builder custom code",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Event or product launch page",
   "text": "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": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add a Vanta.js WAVES background to the hero section with vanta 0.5.24 and three 0.134.0 pinned (no @latest), pass THREE in the options, destroy the effect on unmount, and set a plain background color as a fallback for phones.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Pick an effect and colors on the Vanta site, or start from the README; load three.js first, then the effect file.",
    "source": "<script src=\"https://cdnjs.cloudflare.com/ajax/libs/three.js/r134/three.min.js\"></script>\n<script src=\"https://cdn.jsdelivr.net/npm/vanta/dist/vanta.waves.min.js\"></script>\n<script>\n  VANTA.WAVES('#my-background')\n</script>"
   },
   {
    "tab": "Step 2",
    "intro": "Point it at your block with options; the canvas takes the block's width and height.",
    "source": "VANTA.WAVES({\n  el: '#my-background', // element selector string or DOM object reference\n  color: 0x000000,\n  waveHeight: 20,\n  shininess: 50,\n  waveSpeed: 1.5,\n  zoom: 0.75\n})"
   },
   {
    "tab": "Step 3",
    "intro": "In a bundled app, install the package and import one effect file.",
    "source": "npm i vanta"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "<script src=\"https://cdn.jsdelivr.net/npm/vanta@latest/dist/vanta.waves.min.js\"> with three r121 as in the site snippet",
   "fix": "Install vanta 0.5.24 and three 0.134.0 (the version the README loads) or host those exact files yourself",
   "why": "@latest moves without notice; the README itself loads three r134.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "import BIRDS from 'vanta/dist/vanta.birds.min' with no THREE anywhere on the page",
   "fix": "Pass THREE in the options (BIRDS({ el, THREE })) or load three.min.js in a script tag first",
   "why": "The effect files expect a THREE object; the README says to make sure window.THREE is defined.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "Starting the effect in a React component and never calling destroy()",
   "fix": "Keep the returned effect and call effect.destroy() when the component unmounts",
   "why": "Each effect keeps its own drawing loop running until it is destroyed.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Three or more Vanta effects on one page",
   "fix": "One effect per page, maybe two, with a plain color fallback",
   "why": "The site warns that WebGL effects are slow on older computers.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Resizing the block and expecting the canvas to follow",
   "fix": "Call effect.resize() after the container changes size",
   "why": "The README gives resize() for redrawing at a new size.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": true,
  "self_serve_text": "Agent installs a package or loads it from a CDN",
  "install": "npm install vanta",
  "repo": "https://github.com/tengbao/vanta",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "Customize an effect on vantajs.com and copy the code, or npm install vanta three (pin versions).",
  "formats": [
   "js",
   "html"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Background: Vanta.js (vantajs.com), MIT License",
  "rules_text": "- 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.\n  Connect: npm vanta.\n  Get files: Customize an effect on vantajs.com and copy the code, or npm install vanta three (pin versions) (js, html).\n  Not allowed: Needs three.js (or p5 for some effects)\n  Rule: Keep the MIT notice if you redistribute the code.\n  Rule: Pin three.js/p5 versions that the effect expects.\n  License: https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md (checked 2026-11-05; details: https://agentgid.com/assets/vanta-js/)",
  "agent_md": "https://agentgid.com/assets/vanta-js/agent.md",
  "card_json": "https://agentgid.com/assets/vanta-js/card.json"
 },
 "popularity": {
  "gid_score": 32,
  "stars": 7385,
  "downloads_7d": 47299,
  "downloads_7d_label": "47.3K",
  "downloads_change_4w_pct": 16.8,
  "eco": "npm",
  "package": "vanta",
  "repo": "tengbao/vanta",
  "agent_projects": 2,
  "agent_projects_total": 4817,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     13121
    ],
    [
     "2025-11-24",
     11379
    ],
    [
     "2025-12-01",
     13418
    ],
    [
     "2025-12-08",
     14359
    ],
    [
     "2025-12-15",
     14465
    ],
    [
     "2025-12-22",
     9717
    ],
    [
     "2025-12-29",
     12415
    ],
    [
     "2026-01-05",
     14578
    ],
    [
     "2026-01-12",
     16279
    ],
    [
     "2026-01-19",
     14609
    ],
    [
     "2026-01-26",
     17300
    ],
    [
     "2026-02-02",
     19652
    ],
    [
     "2026-02-09",
     20498
    ],
    [
     "2026-02-16",
     18273
    ],
    [
     "2026-02-23",
     20008
    ],
    [
     "2026-03-02",
     21837
    ],
    [
     "2026-03-09",
     22685
    ],
    [
     "2026-03-16",
     20048
    ],
    [
     "2026-03-23",
     17993
    ],
    [
     "2026-03-30",
     18171
    ],
    [
     "2026-04-06",
     18736
    ],
    [
     "2026-04-13",
     20729
    ],
    [
     "2026-04-20",
     21572
    ],
    [
     "2026-04-27",
     22104
    ],
    [
     "2026-05-04",
     25750
    ],
    [
     "2026-05-11",
     25094
    ],
    [
     "2026-05-18",
     27461
    ],
    [
     "2026-05-25",
     26931
    ],
    [
     "2026-06-01",
     26781
    ],
    [
     "2026-06-08",
     27881
    ],
    [
     "2026-06-15",
     28943
    ],
    [
     "2026-06-22",
     28396
    ],
    [
     "2026-06-29",
     29740
    ],
    [
     "2026-07-06",
     30821
    ],
    [
     "2026-07-13",
     29369
    ],
    [
     "2026-07-20",
     37607
    ],
    [
     "2026-07-27",
     40219
    ],
    [
     "2026-08-03",
     30620
    ],
    [
     "2026-08-10",
     31975
    ],
    [
     "2026-08-17",
     35358
    ],
    [
     "2026-08-24",
     32833
    ],
    [
     "2026-08-31",
     38531
    ],
    [
     "2026-09-07",
     31730
    ],
    [
     "2026-09-14",
     33111
    ],
    [
     "2026-09-21",
     39580
    ],
    [
     "2026-09-28",
     39278
    ],
    [
     "2026-10-05",
     34660
    ],
    [
     "2026-10-12",
     30739
    ],
    [
     "2026-10-19",
     30018
    ],
    [
     "2026-10-26",
     44529
    ],
    [
     "2026-11-02",
     46716
    ],
    [
     "2026-11-09",
     47299
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     7343
    ],
    [
     "2026-11-08",
     7347
    ],
    [
     "2026-11-09",
     7352
    ],
    [
     "2026-11-10",
     7357
    ],
    [
     "2026-11-11",
     7361
    ],
    [
     "2026-11-12",
     7363
    ],
    [
     "2026-11-13",
     7369
    ],
    [
     "2026-11-14",
     7371
    ],
    [
     "2026-11-15",
     7376
    ],
    [
     "2026-11-16",
     7380
    ],
    [
     "2026-11-17",
     7385
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-16"
 },
 "alternatives": [
  {
   "slug": "vanta-js",
   "name": "Vanta.js",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "shadergradient",
   "name": "ShaderGradient",
   "why": "Pick ShaderGradient for a soft 3D color gradient made in a visual editor and placed as a React component.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "tsparticles",
   "name": "tsParticles",
   "why": "Pick tsParticles for particles, confetti and fireworks with ready wrappers for React, Vue, Angular and Svelte.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "granim-js",
   "name": "Granim.js",
   "why": "Pick Granim.js for a small flat animated gradient on a canvas without a 3D library.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "threejs-examples",
   "name": "three.js examples",
   "why": "Hundreds of official three.js WebGL/WebGPU examples (shaders, particles, post-processing, loaders) with full source in the repo's examples folder.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "react-three-fiber-examples",
   "name": "React Three Fiber examples",
   "why": "Gallery of React Three Fiber scenes (shaders, portals, caustics, scroll, physics, glass) linked to runnable sandboxes with source.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use Vanta.js on a client's paid website?",
   "a": "Yes. The MIT license allows use, changes and sale; keep the license notice in copies of the code."
  },
  {
   "q": "Can I put text and buttons on top of the effect?",
   "a": "Yes. Other content inside the same block shows in front of the moving picture."
  },
  {
   "q": "Does it react to the mouse?",
   "a": "Some effects follow the mouse or touch by default; turn this off with mouseControls and touchControls set to false."
  },
  {
   "q": "Will it work on phones?",
   "a": "Not every effect does; the site advises a background image or color as a fallback."
  },
  {
   "q": "Does it work with React or Vue?",
   "a": "Yes. The README shows React and Vue examples that import one effect file and destroy it on unmount."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.5.24",
  "last_commit": "2024-03-03",
  "runtime": "three.js loaded before the effect (the README uses three r134; our demo used three 0.134.0); p5.js for the p5 effects such as Trunk. No peer dependencies are declared in the package.",
  "key_needed": false,
  "formats": "js, html"
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [
  "About 120 kb extra page weight, minified and gzipped, mostly three.js",
  "Runs at 60fps on most laptops and desktops"
 ],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-16",
  "sources": [
   {
    "label": "vantajs.com",
    "url": "https://www.vantajs.com/"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tengbao/vanta/master/README.md"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/tengbao/vanta/master/LICENSE.md"
   },
   {
    "label": "npm: vanta/latest",
    "url": "https://registry.npmjs.org/vanta/latest"
   },
   {
    "label": "npm: vanta",
    "url": "https://registry.npmjs.org/vanta"
   },
   {
    "label": "npm: vanta/0.5.24",
    "url": "https://registry.npmjs.org/vanta/0.5.24"
   },
   {
    "label": "npm: three/0.134.0",
    "url": "https://registry.npmjs.org/three/0.134.0"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/vanta-js/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
