xr843/insect-world

What it solves

This project provides an interactive, web-based 3D encyclopedia for 63 insect species. It solves the problem of static, non-interactive biological illustrations by allowing users to rotate, zoom, and explore the anatomy, life cycles, and ecological roles of insects through a browser-based interface.

How it works

Unlike traditional 3D projects that rely on heavy, pre-made model files, this project generates all 3D insect geometry programmatically using TypeScript and the Three.js library. By defining insects through parametric geometry (e.g., body segments, appendages, and wing venation), the project achieves a lightweight, scalable, and consistent visual style. It includes interactive features like "Isolate" (focusing on parts), "Layers" (transparency), and "Quiz" modes, all running in real-time in the browser.

Who it’s for

It is designed for students, educators, and nature enthusiasts who want an interactive way to learn about insect morphology and life stages. It is particularly useful for those interested in the intersection of web graphics (WebGL/Three.js) and educational content.

Highlights

• Zero Asset Files: Every insect is generated via code, meaning no external 3D model files are required.
• Life Cycle Visualization: Features 74 distinct life-stage models (egg, larva, pupa, adult) for 28 species, including dynamic animations like the emergence of a butterfly.
• Dual Visual Themes: Offers a "Specimen Table" (light mode) and "Museum Night" (dark mode) aesthetic.
• Educational Tools: Includes interactive quizzes, step-by-step guided tours, and comparative views to help users distinguish between species.
• High-Quality Testing: Includes over 4,000 tests to ensure morphological accuracy, anchor point placement, and data consistency.