README.md

H.E.A.T. frontend app docs

On your computer

git clone git@github.com:codeforboston/home-energy-analysis-tool.git
# create an environment file
cd heat-stack
cp .env.example .env

# make sure you're using node version 18
npm install -g nvm
nvm use 20

# install and patch the environment
npm install
npm run dev

Set up in a new GitHub CodingSpace:

# create an environment file
cp .env.example .env

nvm use 20
npm install
npm run dev

If you have the node version manager (nvm), then nvm use 18 avoids engine error with node v19+ or newer which is default. nvm is preinstalled in coding spaces.

In Coding Spaces VSCode always go to hamburger menu -> File-> untick AutoSave. For a pic, see https://stackoverflow.com/a/76659316/14144258

Under special circumstances:

Assume you don't need to, but if the version of pyodide changes run:

cp ./node_modules/pyodide/* public/pyodide-env/

If the pyodide wheel for numpy for your version of pyodide isn't in public/pyodide-env:

• Make sure you have enough space on your computer for 1GB
• Download a full 150+mb release onto your own computer. The filename is something like pyodide-<some version number>.tar.bz2.
• Double click it to extract it. It will take about 1GB to decompress.
• Upload the numpy .whl file into the public/pyodide-env folder.

How do you know if your version of numpy is right? You can check your version of pyodide by running npm list pyodide. You should check that the numpy .whl file name includes the same version number as the output of that command.

If you get an error saying you don't have the right loader:

npm run postinstall

It fixes the loader problem by doing the following programatically:

To re-create the patch for py file support in /patch, use these instructions:

• edit the node_modules/@remix-run/dev/dist/modules.d file to add py, just like sql format.
• edit the node_modules/@remix-run/dev/dist/compiler/utils/loader.ts to add py, just like sql format.
• npx patch-package @remix-run/dev
• it should auto-apply any time you do npm install, but it may get out of sync with upstream

Epic Stack Docs:

The Epic Stack 🚀

Ditch analysis paralysis and start shipping Epic Web apps.

This is an opinionated project starter and reference that allows teams to ship their ideas to production faster and on a more stable foundation based on the experience of Kent C. Dodds and contributors.

npx create-epic-app@latest

The Epic Stack

---

Watch Kent's Introduction to The Epic Stack

"The Epic Stack" by Kent C. Dodds

Docs

Read the docs (please 🙏).

Support

• 🆘 Join the discussion on GitHub and the KCD Community on Discord.
• 💡 Create an idea discussion for suggestions.
• 🐛 Open a GitHub issue to report a bug.

Branding

Want to talk about the Epic Stack in a blog post or talk? Great! Here are some assets you can use in your material: EpicWeb.dev/brand

Thanks

You rock 🪨