Before attending the workshop, please make sure you can run the apps in this repository.
You will need:
Please install them if you don't have them already.
From the command line, clone the repository:
$ git clone https://github.com/reach/react-fundamentals.git
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
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.
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 ofgit
:
$ 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 thenpm install
step. If that's the case, it probably means that at some point you did ansudo 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
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 ryan@workshop.me.