{
 "slug": "theatre-js",
 "name": "Theatre.js",
 "author": null,
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Animation library with a visual timeline editor for motion graphics on the web: animate DOM, three.js/R3F scenes and any JS values.",
 "category": {
  "slug": "motion-examples",
  "name": "Web animation examples and effects"
 },
 "tags": [
  "Code library"
 ],
 "styles": [
  "3d",
  "abstract"
 ],
 "logo_url": "https://agentgid.com/media/avatars/theatre-js.png",
 "logo_letter": "T",
 "links": {
  "repo": "https://github.com/theatre-js/theatre",
  "website": "https://www.theatrejs.com",
  "api_docs": null
 },
 "preview": {
  "kind": "image_grid",
  "src": "https://agentgid.com/assets/theatre-js/demo.jpg",
  "alt": "Seven frames of a headline and button sliding and fading in, and a ball moving across with bounces, all played by the core player from a hand-written animation file.",
  "caption": "Made by AgentGid with @theatre/browser-bundles 0.7.2 (core-only.min.js, npm); no Studio code was loaded. Only the Apache-2.0 core player was used; the animation file and drawings are our own."
 },
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Fully free (open source).",
   "source": {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Yes",
   "status": "yes",
   "sub": "Apache-2.0",
   "quote": "Your use of Theatre.js is governed under the Apache License Version 2.0",
   "note": "The shipped player @theatre/core is Apache-2.0; keep the AGPL Studio out of the product.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": "Keep the notice in code copies",
   "quote": "Your use of Theatre.js is governed under the Apache License Version 2.0",
   "note": "No credit on screen. Keep the license notice inside the code you ship.",
   "source": {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.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 @theatre/core. No key or account is needed.",
   "source": {
    "label": "github.com/theatre-js/theatre",
    "url": "https://github.com/theatre-js/theatre"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Apache-2.0 (@theatre/core); AGPL-3.0 (@theatre/studio)",
  "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md",
  "summary": "The player part is under the Apache 2.0 license: free for paid products if you pass its license on with your app. The editor part is under the stricter AGPL license, so keep it out of the site you ship, as the makers advise.",
  "pages_read": 1,
  "rules": [
   "Ship only @theatre/core in production; @theatre/studio (AGPL) is for design time.",
   "If you ship or host the studio editor, AGPL obligations apply."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "Yes",
    "status": "yes",
    "quote": "Your use of Theatre.js is governed under the Apache License Version 2.0",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "Your use of Theatre.js is governed under the Apache License Version 2.0",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "Can ship inside your app",
    "status": "yes",
    "quote": "only includes `@theatre/core`, so only the Apache License applies.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "The studio (`@theatre/studio`) is released under the AGPL 3.0 License.",
    "source": {
     "label": "raw.githubusercontent.com",
     "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.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/theatre-js/commercial-use/"
 },
 "overview": {
  "heading": "Theatre.js: a visual timeline for web animation",
  "body": "Theatre.js is a free animation library for websites with a visual timeline editor, like a small video editing tool that runs on top of your own page. You set keyframes for a headline, a button or a 3D camera by dragging values, then save the result as a file. Your live site plays that file with the small player part, and the editor stays on your computer."
 },
 "uses": [
  {
   "title": "Intro animation on a landing page",
   "text": "Fade and slide a headline and button into view with exact timing you tune by eye, then ship only the small player with the saved animation.",
   "idea": false,
   "image": null
  },
  {
   "title": "Camera moves in 3D scenes",
   "text": "Plan a camera fly-through, lights or material colors in a three.js or React Three Fiber scene on a timeline instead of guessing numbers in code.",
   "idea": false,
   "image": null
  },
  {
   "title": "Small motion details",
   "text": "Fine-tune hover, press and success animations of buttons and icons, where a few milliseconds and a softer curve change the feel.",
   "idea": false,
   "image": null
  },
  {
   "title": "Animation in time with music",
   "text": "Attach a music or voice track so the animation and the sound always play in sync, for product stories or event pages.",
   "idea": false,
   "image": null
  },
  {
   "title": "Generative and interactive art",
   "text": "Drive any value in your code, such as a color, a noise amount or a particle count, from the timeline for art pieces and interactive visuals.",
   "idea": false,
   "image": null
  },
  {
   "title": "Still frames and a calm version",
   "text": "Jump the animation to any moment to make preview stills, or show a finished still frame to people who turn off motion in their settings.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "Add Theatre.js 0.7.2 (all @theatre packages at the same version): load @theatre/studio only under import.meta.env.DEV, load the animation from state.json with getProject, start it after project.ready, and make sure the production bundle has no @theatre/studio.",
  "install": "npm install --save @theatre/core @theatre/studio",
  "install_note": "The editor is only for development.",
  "code": [
   {
    "tab": "Step 1",
    "intro": "Design the animation in the Studio, export it from the project menu as state.json, and load it in the player.",
    "source": "import { getProject } from '@theatre/core'\nimport projectState from './state.json'\n// This will load the state from the `state.json` file\nconst project = getProject('My Project', { state: projectState })"
   },
   {
    "tab": "Step 2",
    "intro": "Before going live, keep the Studio out of the production build.",
    "source": "if (import.meta.env.DEV) {\n  studio.initialize()\n}"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Calling studio.initialize() unconditionally, or loading core-and-studio.js on the live site",
   "fix": "if (import.meta.env.DEV) { studio.initialize() } with a bundler, or core-only.min.js with the browser bundles",
   "why": "The editor is AGPL and meant for design time; in 0.7.2 core-and-studio.js is about 2.6 MB against about 99 KB for core-only.min.js (our demo check).",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Shipping the site after designing the animation in the Studio, without exporting",
   "fix": "Export state.json from the Studio and pass it: getProject('My Project', { state: projectState })",
   "why": "Until exported, the animation lives only in the localStorage of the browser it was made in.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "sheet.sequence.play() right after getProject()",
   "fix": "project.ready.then(() => sheet.sequence.play())",
   "why": "The project loads its state first; the docs start playback only after project.ready.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "npm install @theatre/core@latest @theatre/studio@0.6 (mixed versions)",
   "fix": "Pin every @theatre package to the same version, e.g. 0.7.2",
   "why": "Each package depends on an exact @theatre/dataverse version.",
   "dont_code": true,
   "fix_code": false
  },
  {
   "dont": "@theatre/r3f 0.7 with an older three or @react-three/fiber",
   "fix": "three >= 0.155.0 and @react-three/fiber >= 8.13.6",
   "why": "This was a breaking change in 0.7.0.",
   "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 @theatre/core",
  "repo": "https://github.com/theatre-js/theatre",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": "npm install @theatre/core (and @theatre/studio as a dev dependency for the editor); animation state is saved as JSON and loaded by core.",
  "formats": [
   "js",
   "json"
  ],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Animation: Theatre.js (@theatre/core, Apache-2.0)",
  "rules_text": "- Theatre.js (Web animation examples and effects, Animation and motion capture, Video references and motion backgrounds). Animation library with a visual timeline editor for motion graphics on the web: animate DOM, three.js/R3F scenes and any JS values. Price: free; commercial use OK; no credit needed; pass the files on to your users only with conditions. Style: 3d, abstract.\n  Connect: npm @theatre/core.\n  Get files: npm install @theatre/core (and @theatre/studio as a dev dependency for the editor); animation state is saved as JSON and loaded by core (js, json).\n  Not allowed: Studio is AGPL\n  Rule: Ship only @theatre/core in production; @theatre/studio (AGPL) is for design time.\n  Rule: If you ship or host the studio editor, AGPL obligations apply.\n  License: https://raw.githubusercontent.com/theatre-js/theatre/main/README.md (checked 2026-11-05; details: https://agentgid.com/assets/theatre-js/)",
  "agent_md": "https://agentgid.com/assets/theatre-js/agent.md",
  "card_json": "https://agentgid.com/assets/theatre-js/card.json"
 },
 "popularity": {
  "gid_score": 44,
  "stars": 13029,
  "downloads_7d": 41410,
  "downloads_7d_label": "41.4K",
  "downloads_change_4w_pct": 48.8,
  "eco": "npm",
  "package": "@theatre/core",
  "repo": "theatre-js/theatre",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [
    [
     "2025-11-17",
     4303
    ],
    [
     "2025-11-24",
     4208
    ],
    [
     "2025-12-01",
     5621
    ],
    [
     "2025-12-08",
     4571
    ],
    [
     "2025-12-15",
     4174
    ],
    [
     "2025-12-22",
     2860
    ],
    [
     "2025-12-29",
     2526
    ],
    [
     "2026-01-05",
     6523
    ],
    [
     "2026-01-12",
     5806
    ],
    [
     "2026-01-19",
     5835
    ],
    [
     "2026-01-26",
     4560
    ],
    [
     "2026-02-02",
     5309
    ],
    [
     "2026-02-09",
     5239
    ],
    [
     "2026-02-16",
     6978
    ],
    [
     "2026-02-23",
     7039
    ],
    [
     "2026-03-02",
     6855
    ],
    [
     "2026-03-09",
     7518
    ],
    [
     "2026-03-16",
     7001
    ],
    [
     "2026-03-23",
     8472
    ],
    [
     "2026-03-30",
     7078
    ],
    [
     "2026-04-06",
     8302
    ],
    [
     "2026-04-13",
     9243
    ],
    [
     "2026-04-20",
     8819
    ],
    [
     "2026-04-27",
     9637
    ],
    [
     "2026-05-04",
     10054
    ],
    [
     "2026-05-11",
     11434
    ],
    [
     "2026-05-18",
     11003
    ],
    [
     "2026-05-25",
     12422
    ],
    [
     "2026-06-01",
     20416
    ],
    [
     "2026-06-08",
     11521
    ],
    [
     "2026-06-15",
     12232
    ],
    [
     "2026-06-22",
     16343
    ],
    [
     "2026-06-29",
     15363
    ],
    [
     "2026-07-06",
     24638
    ],
    [
     "2026-07-13",
     26089
    ],
    [
     "2026-07-20",
     20769
    ],
    [
     "2026-07-27",
     23608
    ],
    [
     "2026-08-03",
     22532
    ],
    [
     "2026-08-10",
     18337
    ],
    [
     "2026-08-17",
     20117
    ],
    [
     "2026-08-24",
     18170
    ],
    [
     "2026-08-31",
     21839
    ],
    [
     "2026-09-07",
     15997
    ],
    [
     "2026-09-14",
     26124
    ],
    [
     "2026-09-21",
     33353
    ],
    [
     "2026-09-28",
     23591
    ],
    [
     "2026-10-05",
     18701
    ],
    [
     "2026-10-12",
     16388
    ],
    [
     "2026-10-19",
     17417
    ],
    [
     "2026-10-26",
     34553
    ],
    [
     "2026-11-02",
     43608
    ],
    [
     "2026-11-09",
     41410
    ]
   ],
   "stars": [
    [
     "2026-11-07",
     12924
    ],
    [
     "2026-11-08",
     12931
    ],
    [
     "2026-11-09",
     12954
    ],
    [
     "2026-11-10",
     12966
    ],
    [
     "2026-11-11",
     12973
    ],
    [
     "2026-11-12",
     12977
    ],
    [
     "2026-11-13",
     12986
    ],
    [
     "2026-11-14",
     12995
    ],
    [
     "2026-11-15",
     13003
    ],
    [
     "2026-11-16",
     13016
    ],
    [
     "2026-11-17",
     13029
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-17"
 },
 "alternatives": [
  {
   "slug": "theatre-js",
   "name": "Theatre.js",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "gsap",
   "name": "GSAP (GreenSock)",
   "why": "Pick GSAP when you prefer to write timelines and scroll effects in code, with all its plugins free and no separate editor.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "auto-animate",
   "name": "AutoAnimate",
   "why": "Pick AutoAnimate when you only need smooth add, remove and move transitions for lists with one function call.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "npm"
  },
  {
   "slug": "animate-css",
   "name": "Animate.css",
   "why": "Pick Animate.css for ready-made bounce, fade and slide effects added with one class name.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "npm"
  },
  {
   "slug": "the-book-of-shaders",
   "name": "The Book of Shaders",
   "why": "Step-by-step online guide to fragment shaders (noise, patterns, shaping functions) with live editable examples; for learning, not reuse.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Non-commercial",
    "status": "no"
   },
   "access": "Download"
  },
  {
   "slug": "hover-css",
   "name": "Hover.css",
   "why": "Collection of CSS hover effects for links, buttons and icons (2D transitions, borders, shadows, icon motion) in CSS, Sass and Less.",
   "current": false,
   "price": "Free tier",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "npm"
  }
 ],
 "faq": [
  {
   "q": "Can I use Theatre.js in a paid product?",
   "a": "Yes for what you ship: the final bundle contains only @theatre/core, which is Apache-2.0, so only the Apache License applies. Keep the Studio out of production."
  },
  {
   "q": "What exactly is AGPL about it?",
   "a": "Only @theatre/studio, the editor you use to make animations. It is meant for design and development time, not for your live site."
  },
  {
   "q": "How do I remove the editor before going live?",
   "a": "With the browser bundles, swap core-and-studio.js for core-only.min.js; with a bundler, do not import Studio in production builds and remove all studio.initialize() calls."
  },
  {
   "q": "Where are my animations stored?",
   "a": "While the Studio is open, in the browser localStorage; export them as a JSON file and pass it to getProject so your site can play them."
  },
  {
   "q": "Does it work with three.js?",
   "a": "Yes. It can animate the camera, lights, material colors and more in three.js, and there is an extension for React Three Fiber."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.7.2",
  "last_commit": "2024-08-14",
  "runtime": "All @theatre packages at the same version (core pins @theatre/dataverse 0.7.2); @theatre/r3f needs three >= 0.155.0 and @react-three/fiber >= 8.13.6. Our demo used @theatre/browser-bundles 0.7.2 core-only.min.js.",
  "key_needed": false,
  "formats": "js, json"
 },
 "good_to_know": [
  "What the editor license means in practice: using the editor on your own computer while you design is fine. Your shipped site then contains only the player.",
  "If you ship or host the editor itself, for example as a tool for your users, the stricter license applies. Changed copies must offer their source code to those users.",
  "Animations you make in the editor are saved only in that browser until you export them as a file, so export before clearing data or switching computers.",
  "The last public release is 0.7.2 from May 2024; the makers moved work to a private place ahead of version 1.0 and say the license stays open.",
  "The simple start needs only an HTML page and a script tag, with no build tools."
 ],
 "stack_snippets": [],
 "claims": [],
 "checked": {
  "license_read": "2026-11-05",
  "overview_checked": "2026-11-09",
  "numbers_updated": "2026-11-17",
  "sources": [
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com"
   },
   {
    "label": "theatrejs.com/docs/latest",
    "url": "https://www.theatrejs.com/docs/latest"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/getting-started"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/getting-started/with-html-svg"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/getting-started/with-three-js"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/getting-started/with-react-three-fiber"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/manual/projects"
   },
   {
    "label": "theatrejs.com/docs/latest/manual/Studio",
    "url": "https://www.theatrejs.com/docs/latest/manual/Studio"
   },
   {
    "label": "theatrejs.com/docs/latest/manual/audio",
    "url": "https://www.theatrejs.com/docs/latest/manual/audio"
   },
   {
    "label": "theatrejs.com/docs/latest/api/core",
    "url": "https://www.theatrejs.com/docs/latest/api/core"
   },
   {
    "label": "theatrejs.com/docs/latest/releases",
    "url": "https://www.theatrejs.com/docs/latest/releases"
   },
   {
    "label": "theatrejs.com/docs/latest/api/studio",
    "url": "https://www.theatrejs.com/docs/latest/api/studio"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/docs/latest/manual/sequences"
   },
   {
    "label": "theatrejs.com/docs/latest/concepts",
    "url": "https://www.theatrejs.com/docs/latest/concepts"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/theatre-js/theatre/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/theatre-js/theatre/blob/main/LICENSE"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/packages/studio/LICENSE"
   },
   {
    "label": "npm: @theatre/core/0.7.2",
    "url": "https://registry.npmjs.org/@theatre/core/0.7.2"
   },
   {
    "label": "npm: @theatre/studio/0.7.2",
    "url": "https://registry.npmjs.org/@theatre/studio/0.7.2"
   },
   {
    "label": "npm: @theatre/core",
    "url": "https://registry.npmjs.org/@theatre/core"
   },
   {
    "label": "npm: @theatre/r3f/latest",
    "url": "https://registry.npmjs.org/@theatre/r3f/latest"
   },
   {
    "label": "npm: @theatre/browser-bundles",
    "url": "https://registry.npmjs.org/@theatre/browser-bundles"
   },
   {
    "label": "theatrejs.com",
    "url": "https://www.theatrejs.com/"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/theatre-js/theatre/main/README.md"
   },
   {
    "label": "npm: @theatre/core/latest",
    "url": "https://registry.npmjs.org/@theatre/core/latest"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/theatre-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."
}
