Viewer Installation

The AODT viewer is a web application for visualizing simulation data, entities, and ray paths on a 3D geospatial map. It can run on any machine with a browser as long as it has network access to the simulation database.

Prerequisites

• Node.js: Vite 7 requires Node.js 20.19+ or 22.12+. This repo is tested with Node.js 24+ and npm 11+.
• A modern web browser with WebGL 2.0 support

Installing Node.js

macOS / Linux (recommended — nvm):

$
nvm install 24
$
nvm use 24
$
$
node -v
$
npm -v

Windows: Download the LTS installer from nodejs.org, run it, then verify with node -v and npm -v.

On Windows you can also use nvm-windows or another version manager.

Installation

From the repository root:

$
cd viewer
$
npm install
$
npm run dev

The application is available at http://localhost:5173. If running on a remote server, access it via the remote server’s IP address: http://<ip>:5173.

If npm install fails

A failed install is often caused by an outdated Node.js version. Check node -v and upgrade if it is below Vite 7’s minimum. Then run a clean install:

$
rm -rf node_modules package-lock.json
$
npm install

Connect to simulation data

After starting the viewer, open Settings in the right sidebar and configure the Iceberg catalog and S3/MinIO endpoint to point at the worker’s database. See the UI section for viewer workflows.

Production build

$
npm run build
$
npm run start