Setup Troubleshooting

Backend

• "Python 3.8 is not found on your system" when running pipenv install or pipenv shell.
  • Follow instructions online to install python3.8 for your system. Run python --version in the shell to check your python version. If this is not 3.8.x, try python3 --version. If you see 3.8.x for either of these, then you have the correct Python version.
• Missing Python dependency/"Module not found"
  • Check that you are in the correct pipenv environment. If you are, (TUTV) should appear at the very start of every terminal prompt.
  • Check that you have the correct dependencies installed. Rerun pipenv install and see if that fixes the issue.
  • If all fails, first quit the pipenv environment with exit then remove it with pipenv --rm. Then reinstall dependencies with pipenv install.
• "SECRET_KEY setting must not be empty"
  • You need a .env file in the project's that specifies the environment variables. Reach out to me about what to put in this file.
  • Make sure that after you place the .env file into the project root, you quit the current pipenv environment with exit and reenter it with pipenv shell
• Error with psycopg2 when running pipenv install
  • This is expected. psycopg2 is a PostgreSQL database adapter and it will fail to install if you don't have PostgreSQL on your system. We aren't using PostgreSQL yet (we will eventually) so this package is not required at the moment.
• "You have _ unapplied migrations"
  • Follow the instructions in the warning message to fix this

Frontend

• Missing JavaScript dependency
  • Run yarn install in the project root to fill in any missing dependencies.
  • If this doesn't work, delete the node_modules folder and try running yarn install again.

Other troubleshooting steps

• Make sure that you have the most up to date master branch by running git fetch then git pull.