JavaScript CSS HTML
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github move stackoverflow nudge in issue template to the bottom Jan 20, 2017
dist Update master CDN URL. (… Mar 22, 2018
docs Add docs of camera parameter for tock method Mar 22, 2018
examples Remove deprecated renderReverseSided and renderSingleSided Mar 13, 2018
scripts Change date format to ISO8601 (#3203) Oct 30, 2017
src Bump aframe-master dist/ builds. (bfff81b...614ea28) Mar 22, 2018
tests Merge pull request #3475 from donmccurdy/bug-cursor-caching Mar 22, 2018
vendor Remove VREffect / VRControls in favor of the new WebGLRenderer API (#… Dec 12, 2017
.gitattributes Aframe gitattributes based on conversations #1586 (#1825) Aug 20, 2016
.gitignore Ignore package-lock.json for now Dec 13, 2017
.jshintrc Add browserify env to .jshintrc (#1831) Aug 20, 2016
.nojekyll allow `ghpages` npm command to push to GH Pages of fork (fixes #197) Sep 24, 2015
.npmignore exclude dist/aframe-v* and minified dists from npm Feb 2, 2017
.travis.yml add node compatibility and regression test (#2484) Mar 15, 2017 [changelog] Remove reverted change. Mar 12, 2018 adapt rust code of conduct as base for aframe code of conduct (fixes #… Jul 22, 2016 add additional contributing instructions for adding glitches Aug 28, 2017
LICENSE Update LICENSE (#2238) Jan 4, 2017 file (fixes #970) Mar 20, 2016 fix readme typo Mar 12, 2018 update roadmap Feb 2, 2018
codecov.yml make codecov find the codecov.yml config Aug 22, 2016
index.html The Purge II: add vr-markup examples, change port to 9001 Sep 24, 2015
package.json Update webvr-polyfill to 0.10.4 for patch to Chrome m65 Mar 17, 2018



A web framework for building virtual reality experiences.

Build Status Coverage Status Downloads Version License

Site β€” Docs β€” School β€” Slack β€” Blog


A-Painter A-Blast A-Saturday-Night Supermedium Musical Forest by @googlecreativelab 360 Image Gallery

Find more examples on the homepage, A Week of A-Frame, and WebVR Directory.


πŸ‘“ Virtual Reality Made Simple: A-Frame handles the 3D and WebVR boilerplate required to get running across platforms including mobile, desktop, Vive, and Rift just by dropping in <a-scene>.

❀️ Declarative HTML: HTML is easy to read and copy-and-paste. Since A-Frame can be used from HTML, A-Frame is accessible to everyone: web developers, VR enthusiasts, educators, artists, makers, kids.

πŸ”Œ Entity-Component Architecture: A-Frame is a powerful framework on top of three.js, providing a declarative, composable, reusable entity-component structure for three.js. While A-Frame can be used from HTML, developers have unlimited access to JavaScript, DOM APIs, three.js, WebVR, and WebGL.

⚑️ Performance: A-Frame is a thin framework on top of three.js. Although A-Frame uses the DOM, A-Frame does not touch the browser layout engine. Performance is a top priority, being battle-tested on highly interactive WebVR experiences.

🌐 Cross-Platform: Build VR applications for Vive, Rift, Daydream, GearVR, and Cardboard. Don't have a headset or controllers? No problem! A-Frame still works on standard desktop and smartphones.

πŸ” Visual Inspector: A-Frame provides a built-in visual 3D inspector with a workflow similar to a browser's developer tools and interface similar to Unity. Open up any A-Frame scene and hit <ctrl> + <alt> + i.

πŸƒ Features: Hit the ground running with A-Frame's built-in components such as geometries, materials, lights, animations, models, raycasters, shadows, positional audio, tracked controllers. Get even further with community components such as particle systems, physics, multiuser, oceans, mountains, speech recognition, or teleportation!



Build VR scenes in the browser with just a few lines of HTML! To start playing and publishing now, remix the starter example on Glitch:


    <script src=""></script>
      <a-box position="-1 0.5 -3" rotation="0 45 0" color="#4CC3D9"></a-box>
      <a-sphere position="0 1.25 -5" radius="1.25" color="#EF2D5E"></a-sphere>
      <a-cylinder position="1 0.75 -3" radius="0.5" height="1.5" color="#FFC65D"></a-cylinder>
      <a-plane position="0 0 -4" rotation="-90 0 0" width="4" height="4" color="#7BC8A4"></a-plane>
      <a-sky color="#ECECEC"></a-sky>

With A-Frame's entity-component architecture, we can drop in community components from the ecosystem (e.g., ocean, physics) and plug them into our objects straight from HTML:


    <script src=""></script>
    <script src=""></script>
    <script src=""></script>
    <script src=""></script>
    <script src=""></script>
      <a-entity id="rain" particle-system="preset: rain; color: #24CAFF; particleCount: 5000"></a-entity>

      <a-entity id="sphere" geometry="primitive: sphere"
                material="color: #EFEFEF; shader: flat"
                position="0 0.15 -5"
                light="type: point; intensity: 5"
                animation="property: position; easing: easeInOutQuad; dir: alternate; dur: 1000; to: 0 -0.10 -5; loop: true"></a-entity>

      <a-entity id="ocean" ocean="density: 20; width: 50; depth: 50; speed: 4"
                material="color: #9CE3F9; opacity: 0.75; metalness: 0; roughness: 1"
                rotation="-90 0 0"></a-entity>

      <a-entity id="sky" geometry="primitive: sphere; radius: 5000"
                material="shader: gradient; topColor: 235 235 245; bottomColor: 185 185 210"
                scale="-1 1 1"></a-entity>

      <a-entity id="light" light="type: ambient; color: #888"></a-entity>


To use the latest stable build of A-Frame, include aframe.min.js:

  <script src=""></script>

To check out the stable and master builds, see the dist/ folder.


npm install --save aframe
# Or yarn add aframe
require('aframe')  // e.g., with Browserify or Webpack.

Local Development

git clone  # Clone the repository.
cd aframe && npm install  # Install dependencies.
npm start  # Start the local development server.

And open in your browser http://localhost:9000.

Generating Builds

npm run dist


For questions and support, ask on StackOverflow.

Stay in Touch


Get involved! Check out the Contributing Guide for how to get started.


This program is free software and is distributed under an MIT License.