Hosting & Publishing
NOTE: This version of the documentation tracks unstable development happening on A-Frame’s
masterbranch. If you wish to try it out, grab the unstable build. Otherwise, head to the documentation for the current 0.7.0 version
This section will show several ways to deploy, host, and publish an A-Frame site and its assets onto the Web for the world to see.
There are many free services to deploy and host a site. We’ll go over some of the more easy or popular options, but there are certainly other options such as AWS, Heroku, or self-hosting. An important note is that these sites should be served with SSL/HTTPS due to a common security restriction of the browser’s WebVR API. All the options below serve with SSL/HTTPS.
“Glitch is the friendly community where you’ll build the app of your dreams With working example apps to remix, a code editor to modify them, instant hosting and deployment - anybody can build a web app on Glitch, for free.”
Glitch is the easiest and fastest way to create and publish a site from within the browser. Glitch lets us add code and files, upload assets, edit with other people, define our own URL name, and instantly deploy changes on every change. We don’t even need to make an account nor login:
- Try going to the A-Frame Starter Glitch.
- Hit Remix your own to copy the project.
- Click the Project info and options icon on the top-left to rename our
- Edit the HTML, add files, modify the project.
- Click Show to view the application (e.g., the starter glitch is hosted at
- Every change to the project will update the application instantly. This can be toggled off by signing in, clicking your user avatar, and toggling Refresh App on Changes.
“Create your own free website. Unlimited creativity, zero ads. Neocities is a social network of 129,100 web sites that are bringing back the lost individual creativity of the web. We offer free web hosting and tools that allow you to create your own web site. Join us!”
Neocities is also another free and easy way to create
and publish a site from within the browser. While it doesn’t have some of the
features of Glitch, Neocities is friendly and lets us upload assets into the
project directory versus a CDN. This makes Neocities at least better at
hosting models. With Neocities, we can create and edit files. They’ll then be
hosted and published for us (e.g.,
“Static web publishing for Front-End Developers Simple, single-command web publishing. Publish HTML, CSS, and JS for free, without leaving the command line.”
Surge is a tool to publish web sites with a single command from the command line. This is a great tool if you’re comfortable with the command line.
“Websites for you and your projects. Hosted directly from your GitHub repository. Just edit, push, and your changes are live.”
GitHub Pages is a preferred way of publishing our
project if our project is on GitHub. The easiest way is to go our project’s
GitHub Settings, scroll down to the GitHub Pages section, and set to
publish master branch. This will publish the project at
Alternatively, we can set to publish the
gh-pages branch if we don’t want
master changes to be published. Command line tools such as
ghpages can make that a one-command
We’ll also go over hosting assets such as audio, textures, models, and video.
If the A-Frame site is being published alongside its assets in the same directory (i.e., the same domain), then we don’t need to worry much about hosting assets. The A-Frame site can use relative URLs to reference the asset, and since they’re on the same domain, there is no issue with fetching that asset. For example, if we have all your resources in the same root directory and we publish everything via Neocities, GitHub Pages, or Surge, there will be no issues.
If we’re hosting assets externally, like on a CDN, then we need to take in
considerations .The primary requirement for assets is that they be served with
cross-origin resource sharing
enabled. This allows the A-Frame site to fetch the asset to display in the
scene. Plus, if we’re using
<a-assets>, we should usually set
crossorigin="anonymous" on assets such as
There are several simple options to host assets via a CDN:
- A-Frame Asset Uploader - Uses UploadCare.
- Glitch Asset Uploader - The Glitch code editor has a panel to upload assets and get CDN URLs in return.
- imgur - For images, we could use imgur, a popular image hosting service.
Hosting models is not as simple. Models usually come as groups of files in a folder, where the model file relatively references other files such as images. Thus, models have to be uploaded as a single folder in the same directory. Many of the free asset hosting services support only uploading one file a time. One solution would be to rename all of the image paths to the CDN paths after the images are individually uploaded, but that is tedious. There are a couple known solutions for easily hosting models via CDN:
If publishing a site via Neocities, we can upload any number of files and directories into the site directory:
Neocities Asset Uploader
Or we can upload assets to a GitHub repository, and use GitHub to serve the model files.
- Go to one of our GitHub repositories.
- Click Upload files.
- Upload our assets and wait for the upload to finish.
- Type a quick message at the bottom and hit Commit changes.
- Wait for processing.
- Once finished, click on the primary asset file.
- Click on Raw.
- Then we have our asset URL hosted on GitHub. We can also change
cdn.rawgit.comto use a different CDN.
Below is a video of the workflow:
Once we’ve published our awesome project, we’ll want to share it so other people dive inside!
A-Frame and VR are very visual; we’ll want to create videos and GIFs of our project.
First, we want to record the screen. On OS X, record the screen using built-in QuickTime Player’s Screen Recording or OBS Studio. On Windows, we can use OBS Studio. OBS Studio also supports streaming and compositing a webcam image on top of the screen, which is useful to show the person using the headset in reality (even with mixed reality).
Then, we can possibly want to trim the video. On OS X, we can use QuickTime
Player’s trim tool (
<cmd> + t).
To convert to a GIF with one command, use gifpardy.
gifpardy uses ffmpeg
and gifsicle under the hood:
If you create something with A-Frame, please share it with us! If you share your project, we’ll feature it on A Week of A-Frame for the community to see. Great channels include:
- Twitter - Mention
@aframevror include the
#projectschannel on Slack
- WebVR Slack channel.
- /r/WebVR subreddit.
- Write a case study and tell us to feature on the A-Frame Blog.
If we want to embed an A-Frame scene into the layout of 2D web page, we can use the embedded component to remove fullscreen styles and allow us to style the canvas with CSS.
Note we can only embed one scene at a time into a page. If we need multiple
scenes, we can use