Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ReactTraining/classic-react-workshop

Lectures and exercises for React Training workshops
https://github.com/ReactTraining/classic-react-workshop

Last synced: 11 days ago
JSON representation

Lectures and exercises for React Training workshops

Lists

README 

        
# Welcome to React Training!



This repo contains the course material for [React Training](https://reacttraining.com/). Before attending the training, please make sure you can run this repository.



## Install



First, install [git](http://git-scm.com/downloads) and the latest stable version of [node](https://nodejs.org/). Then:



```sh

$ 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](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:



```sh

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](http://localhost:8080) where you'll see a list of subjects.



## Be Prepared



**IMPORTANT:** Please read our [JavaScript Primer](https://reacttraining.com/blog/javascript-the-react-parts/) 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](https://gitforwindows.org) 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`:



```sh

$ 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](https://github.com/creationix/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:



```sh

$ 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.



```sh

$ 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](http://www.gnu.org/licenses/gpl-3.0-standalone.html). If you would like to use this material to conduct your own workshop, please contact us at [[email protected]](mailto:[email protected]).