MLH Prep Project

Over the next 2 weeks, you'll be building a React App that works with various APIs (Application Programming Interfaces) that talk to different data sources to do cool stuff.

We're using the OpenWeather API to get weather data on different cities. Your challenge over the next 2 weeks is to build out this website and add even more functionality to it. At the moment, it displays basic information about a location when you type it in. Check out Issues for some more ideas!

You'll need to get your own API Key from their website (for free) and add it as an environment variable in a .env file. We have a template available as example.env.

You'll be using React initially to build this. If you're new to React, check out the website for some information on getting started!

Project Setup for Windows OS:

1. Fork the project:

This creates a copy of the project into repositories of your GitHub account

2. Clone the forked repository:

You need to clone (download) it to your local machine using the below command in terminal

   $ git clone https://github.com/Your_username/prep-project-23.MAR.PREP.2.git

Replace Your_username with your github username because your cloning the forked repository that exists in your github repositories. This creates a local copy of the repository in your local machine

3. Navigate to the forked repository:

Once you have cloned the prep-project-23.MAR.PREP.2 repository into your local machine, move into that folder using the change directory cd command on Linux/ Mac/ Windows

   $ cd prep-project-23.MAR.PREP.2

Next, open the project folder in your favorite code editor/IDE to start coding(the actual game)

4. Installing node and npm:

You need to install node into your machine. navigate to Node.js Download Page and download the latest version that suits your OS and system architecture(x32, x64, x86) check the version of node using below command:

   $ node -v

npm comes installed with node, check npm version using below command:

   $ npm -v

you can install nvm(optional), if you want to manage your node versions which needing to uninstall and install everytime when you want to change the version of node.

5. starting the development server:

After node and npm are ready on your system, now run the below command to install the dependencies if any:

   $ npm install

If it says there are some vulnerabilities, try running below command to fix some of the non-critical ones:

   $ npm audit fix

Then run the below command to start the development server:

   $ npm start

If the development server didn't start and if it throws the error Error: error:0308010c:digital envelope routines::unsupported, then one of the possible fix is to update the react-scripts Steps to do the fix:

Check the package.json file
see if react-scripts version under dependenciesis < 5.0.0. if so try updating using below commands:

   $ npm uninstall react-scripts
   $ npm install react-scripts

then run the command $ npm start to start the development server on your local machine again.

For more information, refer this link

Disclaimer: Do not run $ npm audit fix --force to fix the vulnerabilities because this breaks/downgrades the react-scripts version