PolySculpt

A procedural geometry engine for generative, fractal, and rep-tile 3D forms. Built with React Three Fiber, real-time parameter control, and a node-based authoring layer.

PolySculpt renders mathematically generated solids, fractals, rep-tiles, spirals, lattices and lets you sculpt them live: depth, scale, symmetry, and color, with direct export to 3D-printable formats or high-resolution wallpapers.

---

Features

• Procedural geometry library — Sierpinski triangle, Menger sponge, golden-ratio spiral, rep-tile subdivisions (square, triangle, sphinx), radial mandalas, torus, and crystal lattice forms, all generated parametrically rather than loaded from static assets.
• Live parameter controls — scale, recursion depth, symmetry, and color palette update the model in real time.
• Node graph system — a visual, node-based layer (NodeGraph.tsx) for composing geometry and signal-processing operations (wave interference, field generation, correlation) into custom forms, beyond the preset shape list.
• Export pipeline
  • 3D models to OBJ / STL, ready for CAD or 3D printing.
  • Still renders to PNG wallpaper at FHD, QHD, 4K, and common mobile/tablet resolutions.
• Monochrome-first rendering — white background, black/charcoal model by default, with optional color palettes for users who want them.

Tech Stack

• React + TypeScript + Vite
• React Three Fiber / Three.js for rendering
• Zustand for state
• Radix UI + Tailwind for interface
• Express + Drizzle ORM scaffold (currently in-memory storage; no live database dependency)

Getting Started

git clone git@github.com:UUON-Foundation/PolySculpt.git
cd PolySculpt
npm install
npm run dev

The app runs on http://localhost:5000 by default.

Production build

npm run build
npm run start

Project Structure

client/src/
  components/        UI panels (parameters, export, node graph) and the R3F canvas
  lib/geometry/       Procedural shape generators (fractals, rep-tiles, tessellation)
  lib/nodes/          Node graph primitives (geometry ops, signal/field nodes)
  lib/exporters/      OBJ/STL and wallpaper export logic
  lib/stores/         Zustand state for the active shape and parameters
server/               Express app (API scaffold; currently stateless)
shared/                Shared schema types

Status

Actively developed. Current focus: refining the export pipeline and expanding the node graph's geometry operators.

License

MIT