Run & Deploy (minimal 3D viewer)

This guide serves as minimal deploy of a 3D viewer based on ATON, in scenarios where you are NOT able to install NodeJS on your machine/server.

This means you won’t have access to several features/services of the ATON framework, such as users’ authentication, real-time collaboration, REST APIs, 3D scenes live editing, and more (…or you have to implement yourself). So if you have a local (offline) installation or the possibility to install NodeJS, please follow this simple tutorial.

The setup is super-easy with minimal steps, given you have already a basic hosting or access to a web-server (purely serving files)

First off, you grab the latest version of ATON framework from official github, lets say the zip package. Unzip somewhere, then go to /public/ subfolder and upload just these folders on your web-server (via ftp or whatever you are using to upload files to your web-server) in the top level folder

At this point, you should be able to reach the standalone/ folder via <your-domain-or-IP>/standalone/. You should see something like this:

That’s it! It’s working

Now, this sample App is a basic standalone viewer to load 3D models or scenes.

You can start from there to develop your basic app (tipically a simple 3D viewer) or just use this one as it is. More specifically, this sample viewer loads 3D models and scenes from the /assets/ subfolder (inside standalone/): you can see you have already there a sample glTF 3D model – atoncube.glb

We can rename the “standalone” folder with a customized name you like, lets say “myapp“:

Now you can load a specific 3D model from your assets/ folder using url parameter like this: <your-domain-or-IP>/myapp/?m=atoncube.glb

or a scene (see scene descriptors) using <your-domain-or-IP>/myapp/?s=scene

That’s it!

You can indeed populate the assets/ folder with your 3D models using supported 3D formats, and present them through a specific url. Of course if you need something more advanced, you can customize the code in js/main.js, or use more advanced front-ends like Hathor.

You can see a live sample of this minimal 3D viewer here: