ReactTraining/classic-react-workshop

README

Welcome to React Training!

This repo contains the course material for React Training. Before attending the training, please make sure you can run this repository.

Install

First, install git and the latest stable version of node. Then:

$ git clone https://github.com/ReactTraining/react-workshop.git
$ cd react-workshop
$ npm install
$ npm start

Then, open a web browser to http://localhost:8080 where you'll see a list of subjects.

Updating

If you've already cloned the repo but you need to get updated code, then follow these steps:

First, cd into the root directory of the repo
Then do an ls command to ensure you see a package.json file listed. If you don't you're not in the root folder of the repo
Then run these steps to get the updates:

git pull origin master
npm install

Then you should be able to do your npm start and open a web browser to http://localhost:8080 where you'll see a list of subjects.

Be Prepared

IMPORTANT: Please read our JavaScript Primer before attending the workshop. It's a refresher on some of the newer bits of JavaScript you'll want to be familiar with in order to get the most out of the experience.

Windows Machine?

We'll be running commands like the ones from the install/update instructions above. These are bash commands which means if you're on Windows you'll need a bash-enabled command-line tool. If you've installed Git For Windows then you'll have a command-line tool called Git Bash already. This seems to work out well for doing other bash things that aren't just git specific (like NPM).

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 us at hello@reacttraining.com.