How icosa-foundation/gallery-viewer works
Main Components
a. Core Viewer Component
• Role in rendering different 3D file formats
• Viewer.ts as the entry point
b. Format Handlers
• GLTF 1.0 (Legacy)
• GLTF 2.0
• Tilt files
• GLB files
c. Helper Systems
• Navigation system (from src/helpers/Navigation.ts)
• Legacy support system (from src/legacy/)
Component Relationships
File Input → Format Handlers → Core Viewer → Rendered Output
• ↑
• Legacy Support System
Technical Stack Elements
Key technical aspects:
• TypeScript (evident from tsconfig.json)
• Three.js (implied by 3D visualization)
• CSS styling layer (from src/css)
┌─ Input Layer ─────┐ ┌─ Processing Layer ─┐ ┌─ Output Layer ──┐
• GLTF 1.0 │ │ - Core Viewer │ │ - Rendered 3D │
• GLTF 2.0 │ → │ - Format Handlers │ → │ Scene │
• Tilt Files │ │ - Navigation │ │ - Interactive │
• GLB Files │ │ - Legacy Support │ │ Controls │
• ┘ └─────────────────┘ └───────────────┘
Important Details
a. File Format Support:
• Clear separation between modern and legacy format support
• Format conversion flows
• Supported file extensions (.tilt, .gltf, .glb)
b. Integration Points:
• How it integrates with Icosa Gallery
• Potential integration points for other systems
c. Asset Management:
• How different assets (models, textures) are handled