// the find
hululuuuuu/GlobeStream3D
基于threejs开发的3D地球2D 地图 js组件，适用所有前端js框架 Building 3D visualization based on three.js, High efficiency component
GlobeStream3D is a three.js wrapper that renders interactive 3D globes and 2D maps with fly-lines, scatter points, bars, and animated routes — the kind of thing you see on Chinese enterprise dashboards. It targets frontend developers who need a data visualization globe without building one from scratch, and it works with any framework since it's vanilla JS under the hood.
The 3D/2D parity design is genuinely useful — same config object drives both modes, so you're not maintaining two separate visualization setups. TypeScript throughout with a real interface file means autocomplete actually works rather than being a lie. Bundled geo data (world.json, China routes) means you're not hunting for compatible GeoJSON. Custom GLSL shaders for map lines rather than relying purely on three.js built-ins gives better visual control over the animated effects.
The codebase is maintained by one person who explicitly says he has limited time due to a day job — the README opens with this caveat, which is honest but also a support SLA warning. No tests anywhere in the tree; figure classes like Earth.ts and FlyLine3d.ts are untested black boxes. The bundled world.json is a static snapshot with no clear update path for boundary changes. Documentation is split across two external URLs (Netlify and Vercel) with no guarantee of staying in sync with the code.