Kaleidoscope is an open-source embodied carbon design tool built for transparency, interoperability, and rapid prototyping in sustainable architecture workflows. It is designed with the following goals:
- Modular, API-ready architecture for integration into firm-wide design tools
- Public GitHub repository with full documentation and commit history
- Supports both local deployment (
npm start) and embedded deployment (WordPressand GitHub Pages) - Easy-to-customize interface and backend logic for decarbonization workflows
Kaleidoscope is not just a standalone tool—it is a foundational module in a larger platform ecosystem currently under development, designed to integrate seamlessly with generative design engines, simulation dashboards, and interactive review tools.
- Install nodejs // only need to do this once (install the program; this is not a command)
- Clone this repository // only need to do this once
- npm install // only need to do this once
- npm start
Then head to http://localhost:3000
-
This allows you to view changes as you edit
-
Save the file you're working on and then localhost:3000 will refresh with your changes
-
Type CTRL+C in terminal to stop npm start command
-
Do this before you move to the next step for production build
- npm run deploy
- view at https://payette.com/kaleidoscope/ or https://payette.github.io/Kaleidoscope/
Paste contents of wordpress_embed_code.html into a page at the payette.com Wordpress site to embed Kaleidoscope into a Wordpress page. You only have to do this one time, or anytime you update the wordpress_embed_code.html file.