@yschindel/ara3d-webgl
v1.3.10
Published
A 3D viewer designed for large architectural (BIM) models built on top of Three.JS.
Maintainers
Readme
Ara 3D WebGL - BIM Open Schema Viewer
Live Demo
A WebGL viewer for extremely large 3D models of buildings and infrastructure represented as BIM Open Schema .BOS files.
BIM Open Schema is an ultra-compressed and portable BIM data format, which is easily extended, built on top Parquet format. A .BOS file is a ZIP archive that contains multiple Parquet files, which contain geometry, parameters, and other BIM data.
Building and Running
The project uses vite for bundling and development.
Some of the common tasks, which can be found in the package.json.
npm run dev- Running the vite dev server with "hot reloading"npm run build:docs- Building the examples and API documentation.npm run serve:docs- Testing the built examples and API documentation locallynpm run build:lib- Building the library as a JavaScript module (.mjs) file
Camera Controls
Keyboard
W,Up- Move camera forwardA,Left- Move camera to the leftS,Down- Move camera backwardD,Right- Move camera to the rightE- Move camera upQ- Move camera downShift- faster camera movement while pressed+- Increase camera speed-- Decrease camera speedSpace- Toggle orbit modeHome- Frame modelEscape- Clear selectionFFrame selection
Mouse
Hold left click + Move mouse- Rotate camera in current modeHold right click + Move mouse- Pan/tilt cameraHold middle click + Move mouse- Truck/pedestal cameraMouse wheel- Dolly CameraLeft click- Select objectCtrl + Mouse wheel- Increase/decrease camera speed
Touch
One Finger swipe- Tilt/Pan cameraTwo Finger swipe- Truck/Pedestal cameraTwo Finger pinch/spread- Dolly Camera
History
At Ara 3D we created a simple 3D web-viewer in March 2019 which had support for multiple file formats. The goal was to minimize the amount of code required to create and host a Three.JS viewer in a web-page.
The VIM team took over the project in July 2021 and the team, mostly Simon Roberge, added many features and enhancements. They also customized the project to meet the needs of their Power BI offering.
On December 17, 2024, the VIM team archived the project, and merged it with their React-based viewer project into a new repository https://github.com/vimaec/vim-web. Today the VIM viewer is very powerful, but has become very specialized to their use-cases.
In early 2025 the Ara 3D WebGL project was forked from an earlier snapshot of the repo to revive the spirit of the original viewer, while leveraging many of the excellent contributions made by VIM.
Today in December 2026, we are focusing on using this viewer as a showcase of the BIM Open Schema data format.
Requesting Features, Improvements, or Changes
Feel free to log issues or submit pull requests.
We also offer very affordable custom software development services if you are using this project in a commercial context. For more information reach out to us at [email protected].
