mhsenkow/geodesic

Geodesic is a browser based design tool for people who build geodesic domes, the rounded triangle covered structures often seen in playgrounds, greenhouses, and DIY shelters. Instead of hand designing the connector hubs that join the dome's struts together at each joint, this tool lets you configure the dome's overall shape and material, then generates and previews those hub pieces in 3D and exports them as STL files ready to send to a 3D printer. You can choose from several dome shapes, ranging from partial shallow caps to full spheres, built from icosahedral, octahedral, or tetrahedral geometry, with an optional door opening. The tool supports round materials like PVC pipe or EMT conduit as well as rectangular timber, and generates matching socket shapes for whichever material you pick. A core part of the tool is its hub engine, which blends the joint and strut shapes together into one smooth, organic looking piece inspired by a style called Weaverbird geometry, then cuts out screw holes and entry bevels, always producing a single solid shape that prints cleanly with no gaps. You can also choose a sharper, less organic hub style instead if you prefer. The interface includes a 3D preview where you can inspect each hub, color struts by length, and check that everything fits before printing. Exports include the STL files themselves plus a spreadsheet of strut lengths and an image map showing where each hub goes on the finished dome, along with saved presets so you can return to a configuration later. It is built with TypeScript, Vite, and the Three.js graphics library, with automated tests and a live demo hosted through GitHub Pages. The project is released under the MIT license, meaning anyone can use, modify, and share it freely.