Welcome to React Fundamentals!

Before attending the workshop, please make sure you can run the apps in this repository.

Step 1 - Dependencies

You will need:

• Git
• node
• yarn (Optional. Not Required if you use NPM)

Please install them if you don't have them already.

Step 2 - Clone the repository:

From the command line, clone the repository:

$ git clone https://github.com/reach/react-fundamentals.git

Step 3 Install Each Lesson

Each section is a separate app using Create React App. This repo has a script to install all of them at once.

If you are using yarn run from the root of the repository:

yarn

If you are using npm, run from the root of the repository:

npm run install

Step 4 - Run an app

Once the dependencies are installed, you can run the app for a lesson:

cd 1-rendering
yarn start
# or
npm start

Your browser should open up to a running app.

Troubleshooting

A few common problems:

• You're having problems cloning the repository. Some corporate networks block port 22, which git uses to communicate with GitHub over SSH. Instead of using SSH, clone the repo over HTTPS. Use the following command to tell git to always use https instead of git:

$ git config --global url."https://".insteadOf git://

# This adds the following to your `~/.gitconfig`:
[url "https://"]
  insteadOf = git://

• You're having trouble installing node. We recommend using nvm. nvm makes it really easy to use multiple versions of node on the same machine painlessly. After you install nvm, install the latest stable version of node with the following command:

$ nvm use default stable

• You don't have permissions to install stuff. You might see an error like EACCES during the npm install step. If that's the case, it probably means that at some point you did an sudo npm install and installed some stuff with root permissions. To fix this, you need to forcefully remove all files that npm caches on your machine and re-install without sudo.

$ sudo rm -rf node_modules

# If you installed node with nvm (suggested):
$ sudo rm -rf ~/.npm

# If you installed node with Homebrew:
$ sudo rm -rf /usr/local/lib/node_modules

# Then (look ma, no sudo!):
$ npm install

License

This material is available for private, non-commercial use under the GPL version 3. If you would like to use this material to conduct your own workshop, please contact me at [email protected].