Changelog

Release notes and version history for BelowJS.

Latest Release:
npm install belowjs@1.1.0
1.1.0
Minor
September 3, 2025

New screenshot capture capability and example updates.

  • New Screenshot capture button in the viewer UI
  • New enableScreenshot config option on ModelViewer
  • New takeScreenshot() method to programmatically save a PNG
  • Improved Renderer now uses preserveDrawingBuffer to support screenshots
  • Improved Examples updated to include enableScreenshot: true and CDN references bumped to 1.1.0
1.0.0
Stable Release
August 27, 2025

🌊 First stable release of BelowJS! Production-ready underwater VR viewer with comprehensive documentation and full feature set.

Now Live in Production: BelowJS 1.0.0 is powering WreckSploration VR - the first production implementation featuring shipwreck exploration in virtual reality.

Release Highlights

  • Stable API: Production-ready with comprehensive documentation
  • WebXR Support: Full VR functionality optimized for Meta Quest 3
  • Measurement Tools: Desktop and VR measurement systems
  • Dive Mode: Underwater lighting and particle effects
  • Multiple Examples: Basic, drag-drop, and embeddable viewers

Technical Details

  • Built on Three.js with modern ES modules
  • Modular architecture with clean separation of concerns
  • Comprehensive documentation and examples
  • Production-ready with thorough testing
1.0.0-rc.4
Release Candidate
August 19, 2025

Documentation improvements, implementation showcases, and production readiness updates.

  • Fixed Info panel not showing properly by adding below-panel class
  • Improved Documentation structure and navigation
  • Added Comprehensive guides for development workflows
  • Added WreckSploration VR implementation showcase
1.0.0-rc.3
Release Candidate
August 14, 2025

Loading improvements and documentation enhancements.

  • Fixed Loading spinner percentage clamped to maximum 100%
  • Fixed Loading spinner display issues in light mode
  • Improved Example documentation clarity and structure
1.0.0-rc.2
Release Candidate
August 12, 2025

Key improvements to VR model switching and loading experience.

  • Fixed VR locomotion reset bug when switching models
  • New VR loading indicator for model changes
  • Improved Audio system robustness
  • New Complete static documentation site
1.0.0-rc.1
Release Candidate
August 2025

First release candidate for BelowJS 1.0! This version is production-ready and available on NPM.

  • New Complete underwater VR viewer with dive mode and lighting effects
  • New WebXR support for immersive VR experiences on compatible headsets
  • New Measurement tools for archaeological documentation
  • New Multi-model support with dropdown switching
  • New Customisable lighting and dive environment
  • New Touch and keyboard controls for accessibility
  • New Drag-and-drop model loading
  • New Embed viewer for iframe integration
  • New Complete documentation and examples
  • Improved Bundle size optimised to 419KB
  • Improved Performance for large photogrammetry models
  • Improved Mobile device compatibility

Breaking Changes: This is the first public release, so no breaking changes from previous versions.

Known Issues: None currently reported. Please file issues on GitHub.

Pre-Release Development
2024-2025

Extensive development and testing phase for underwater photogrammetry visualization:

  • Core Three.js integration and scene management
  • WebXR implementation for VR headset support
  • Maritime archaeology measurement tools development
  • Dive mode with realistic underwater lighting
  • Performance optimisation for large 3D models
  • Testing with real underwater photogrammetry models
  • Documentation and example creation