Skip to content

Kinanqaz/Navio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

109 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Navio — IFC & 3D Model Viewer

Navio Interface

FeaturesTechnology StackGetting Started

Overview

Navio is a professional-grade web-based viewer for IFC (Industry Foundation Classes) and 3D building models. It combines advanced 3D visualization with BIM intelligence, enabling architects, engineers, and construction professionals to inspect, analyze, and collaborate on building information models directly in the browser. The application also supports GLB files as assets, allowing users to enrich scenes with detailed 3D models for more professional and immersive visualizations.

Key Capabilities:

  • Photorealistic rendering with PBR materials and real-time shadows
  • Immersive VR exploration through WebXR
  • Client-side processing for privacy and performance
  • AI-powered natural language interactions with model data
  • Comprehensive BIM tools including measurement, property inspection, and BCF support

Features

File Support & Performance

  • IFC Parsing — Native IFC file loading with full element property access
  • Multi-Format Support — Simultaneous loading of IFC, GLB, and GLTF files
  • Client-Side Processing — All operations performed locally; no cloud uploads required
  • Georeferencing — Automatic coordinate normalization for large-scale projects
  • Performance Optimized — Efficient handling of complex models with smooth interaction

Visualization & Rendering

  • Real-Time Shadows — Configurable shadow mapping with adjustable intensity, azimuth, and elevation
  • Dynamic Lighting — Responsive lighting system for accurate material representation
  • Post-Processing Pipeline — High-quality rendering for professional presentations
  • PBR Materials — Full support for diffuse, normal, roughness, and ambient occlusion maps
  • Smart Texture Assignment — AI-powered material application based on element classification
  • Custom Texture Upload — Upload complete texture sets with automatic map detection
  • UV Controls — Scale and rotation adjustment for precise texture mapping
  • Material Library — Built-in categories (concrete, wood, metal, glass, etc.)
  • Material Export/Import — Save and share material configurations between projects

PBR Materials

VR & Immersive Experience

  • WebXR Compatible — Works with all major VR headsets (Meta Quest, HTC Vive, etc.)
  • Controller Integration — Full VR controller support for navigation and element selection
  • Ray-Based Selection — Point and select elements in virtual space
  • Seamless Mode Switching — Toggle between desktop and VR modes instantly
  • True-Scale Navigation — Walk through buildings at actual scale
  • Built-in VR Guidance — Instructions for first-time VR users

VR Mode

BIM & Collaboration Tools

  • Model Tree — Hierarchical navigation of building elements
  • Property Inspection — Detailed element attributes and metadata
  • Measurement Tools — Point-to-point and linear distance measurement
  • Color Overrides — Visual highlighting and custom element coloring
  • Visibility Control — Isolate, hide, and filter elements by type or properties
  • BCF Integration — Building Collaboration Format support for issue tracking
  • AI Chat Assistant — Natural language queries about model data

alt text


Technology Stack

Category Technologies
Frontend Framework React 19, TypeScript
Styling Tailwind CSS
3D Engine Three.js, React Three Fiber
VR/XR WebXR API, React Three XR
IFC Processing web-ifc, web-ifc-three (deprecated fork)
UI Components Radix UI, shadcn/ui
Build Tool Vite
Package Manager Bun

Getting Started

Try It Online

You can try Navio without any installation by visiting the live deployment on Vercel: [https://navio-ifc.vercel.app/]

Prerequisites

  • Modern web browser (Chrome, Firefox, Edge, or Safari — latest versions)
  • VR headset (optional, for immersive mode — Meta Quest, HTC Vive, etc.)

Installation

# Clone the repository
git clone https://github.com/Kinanqaz/Navio.git
cd Navio

# Install dependencies (using Bun)
bun install

# Start development server
bun run dev

# Open http://localhost:5173 in your browser

Alternative: Using npm

npm install
npm run dev

Architecture Notes

Navio utilizes a maintained fork of the deprecated web-ifc-three repository for generative geometry. This decision was made because newer technologies, such as the fragments system, present significant challenges when working with advanced texturing workflows and VR mode integration. The deprecated fork provides the necessary stability and feature compatibility for Navio's specific use cases, particularly in handling complex material systems and WebXR functionality.


Connect

Built with passion for the BIM and AEC community. Feedback and contributions are welcome.


Built with ❤️ for the AEC industry. Licensed under MIT.

Releases

No releases published

Packages

 
 
 

Contributors