j40-cejst-2/INSTALLATION.md

Installing the Justice40 Tool

¡Lea esto en español!

Required Software

• git, node, yarn, gatsby-cli, and an IDE

Install Git

MacOS

1. Open the terminal and type git and hit RETURN.
2. If dev tools are not installed a window will prompt you to install dev tools.
3. Open the terminal and type git --version and hit RETURN.
4. Validate that a version number is returned. If so, git is properly installed.

Win10

Download from website

Install Homebrew (MacOS only)

1. Open the terminal and copy / paste this command and hit RETURN.

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

2. Validate installation by typing brew -v in the terminal and ensure a version number is shown.

Install Node using NVM

This will work for both MacOS and Win10. Follow instructions on this link

Install Yarn and Gatsby CLI

• This is for both MacOS and Win10
• Note that while this app uses npm as the package manager, yarn is required to build the uswds library.

1. Open the terminal and type sudo npm install -global yarn and hit RETURN.
   1. Type yarn -v and hit RETURN
   2. Verify a version number is shown
2. Open the terminal and type sudo npm install -global gatsby-cli and hit RETURN.
   1. Type gatsby-cli -v and hit RETURN
   2. Verify a version number is shown

IDE set up

While any IDE can be used, we're outlining how to set up VS Code

1. Open the terminal and type brew install --cask visual-studio-code and hit RETURN.
   1. If this doesn't work or for Win10, you can download VS Code from the website.
2. After forking this repo, you can clone your forked repo into VS Code
3. VS Code with prompt you to "clone a repo"
4. Open the terminal and navigate to client directory
5. Type npm install to load dependencies
6. Type gatsby develop to spin up the app
7. Navigate to localhost:8000 to view the app

Recommended VS Code Extensions

1. Browser Preview
2. Live Server
3. Live Share
4. Live Share Audio
5. Live Share Extention Pack