a web framework for building virtual reality experiences.
Under MIT License
By aframevr

3d html threejs game-engine oculus virtual-reality vr aframe webvr virtualreality ecs vive rift daydream


A web framework for building virtual reality experiences.







Special Sponsors


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


:eyeglasses: 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>.

:heart: 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.

:electric_plug: 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

:zap: 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.

:globe_with_meridians: 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.

:mag: 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.

:runner: 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:



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:




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



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

And get in touch with the maintainers!


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

You can also support development by buying a gorgeous A-Frame t-shirt with exclusive designs


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