Skip to content

SustainableUrbanSystemsLab/DesignExplorer

 
 

Repository files navigation

Design Explorer

Deploy CI License: MIT

Interactive parametric design space explorer. Visualize, filter, and compare design alternatives from Grasshopper/Rhino parametric studies using parallel coordinates, scatter plots, and 2D/3D viewers.

Live Demo

Quick Start

npm install
npm run dev

CSV Format

Prefix Meaning Example
in: Input parameter in:Depth [ft]
out: Output metric out:Cooling[kWh]
img Image path img, img:perspective
threeD 3D model (glTF/STL/OBJ) threeD

Commands

Command Description
npm run dev Dev server
npm run build Production build
npm test Unit tests
npm run check Type check
npm run release:dry-run Preview the next semantic release

Versioning

Releases are automated from commits on main using Semantic Versioning.

Use Conventional Commits so the release workflow can choose the right version bump:

Commit type Version bump
fix:, perf:, refactor:, style:, docs:, test:, build:, ci:, chore: Patch
feat: Minor
BREAKING CHANGE: in the commit body, or ! after the type/scope Major

The release workflow updates package.json, package-lock.json, and CHANGELOG.md, creates a vX.Y.Z tag and GitHub Release, then deploys the versioned build to GitHub Pages.

Tech Stack

Svelte 5 • TypeScript • D3 v7 • Three.js • Tailwind CSS 4 • Vite

License

MIT — Sustainable Urban Systems Lab

About

Design Explorer is an open source web interface for exploring multi-dimensional design spaces

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • Svelte 53.1%
  • TypeScript 44.1%
  • HTML 1.7%
  • Other 1.1%