Building blocks for the VR Web.

To learn more, head over to the A-Frame site for examples, docs, and FAQ.

For the core library, check out A-Frame Core.

If you want to get started immediately, just fire up this CodePen example scene!

If you would like to embed this library in your project, simply include this file:

• aframe.min.js

Or if you'd prefer the unminified version for local development (with source maps):

• aframe.js

Also, be sure to check out the awesome examples (or the ones in this repository).

First install from npm:

npm install aframe

And in your Browserify/Webpack modules, simply require the module:

require('aframe')

Alternatively, you can clone this repository to work locally on this project and explore the examples.

git clone [email protected]:aframevr/aframe.git
cd aframe && npm install

To start the local development server:

npm start

And fire up https://localhost:9000!

If you'd like to see helpful logs, warnings, and errors, you can enable logging from the console of your favourite developer tools:

localStorage.logs = 1

And to disable:

localStorage.logs = 0

Ensure you have cloned the repo and installed the dependencies.

If you want to make changes to the aframe-core library and test with aframe, you'll need to run these commands to link things up correctly.

When you are in the directory of your aframe-core repo checkout:

npm link

When you are in the directory of your aframe repo checkout:

npm link aframe-core

Now when you make changes to aframe-core, those changes will get reflected when a bundle gets built (the page is refreshed or a aframe file is changed), so you can test the aframe-core dependency against aframe without having to manually push things to npm for testing (which is a big no no!).

You'll need to npm unlink when you are done testing things and want to actually use the npm-published versions, not your versions that are locally linked.

From your aframe-core directory:

npm unlink

From your aframe directory:

npm unlink aframe-core

To increment the preminor version of the package (e.g., 0.1.19 to 0.1.20) and create a git tag (e.g., v0.1.20):

npm run release:bump

NOTE: npm versions cannot be unpublished.

Once the package is 100% ready to go, to push the new version to npm (e.g., 0.1.20) and to the new tag to GitHub (e.g., v0.1.20):

npm run release:push

npm run dist
git commit -am 'Bump dist'

To publish to https://aframevr.github.io/aframecore/:

npm run ghpages

To publish to https://your_username.github.io/aframe/:

npm run ghpages your_username

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