Getting Started - For all those who are confused.
If you looked at this Twitter Post and came here to reproduce what was shown in the video, locally, you might be a bit confused.
Since the repo seems to be stagnant and the README is a bit vague, I am attempting to clear up some of the confusion.
General Usage
If you simply wish to try the project out, there's a live deployment. Although this doesn't work as intended on my browser.
Or, if you want to try it out locally, you need to:
- Clone the repository.
- Start a server using the cloned repo using any tool of your liking (try serve, or live-server), then go to the server url in your browser.
Note: Simply opening index.html will show you a white screen.
At this point, you will see a spinning cube with red edges, that means everything is fine.
What about the Spheres?
This is just a stripped down version of that project, intended to be a basic example, hence the red cube. You can create someting similar by experimenting a bit. See here.
Note: These answers have been posted in other issues on this repo as well, I have tried to put all the basic answers together in one place. If @bgstaal wants, I can add these in the README as well.
Alternatively, after cloning the project, start (kill exisitng sessions first) your Chromium based browsers with the flag --allow-file-access-from-files
Normal systems:
$: /Applications/Chromium.app/Contents/MacOS/Chromium --allow-file-access-from-files
or
$: chromium-browser --allow-file-access-from-files
or
$: chromium --allow-file-access-from-files
Windows:
%USERPROFILE%\AppData\Local\Google\Chrome\Application\chrome.exe --allow-file-access-from-files
Then open the index.html