diff --git a/README.md b/README.md
index 47eba10df..fbabe96f8 100644
--- a/README.md
+++ b/README.md
@@ -86,7 +86,7 @@ macOS developers will need:
 git clone git@github.com:coreos-inc/quay.git && cd quay
 
 # Install the system dependencies
-brew install libevent libmagic postgresql gpgme pyenv pyenv-virtualenv pyenv-pip-rehash docker docker-machine node
+brew install libevent libmagic postgresql gpgme pyenv pyenv-virtualenv pyenv-pip-rehash docker docker-machine node yarn
 
 # Create a default virtualmachine for docker
 docker-machine create -d virtualbox default
@@ -118,10 +118,10 @@ git clone git@github.com:coreos-inc/quay-config.git ../quay-config
 ln -s ../../quay-config/local conf/stack
 
 # Install Node Dependencies
-npm install
+yarn install
 
 # Link Typescript
-npm link typescript
+yarn link typescript
 ```
 
 #### Third Party Docs
@@ -172,8 +172,9 @@ go get github.com/mattn/goreman
 
 * `local-run` runs the web server for testing
 * `local-test` runs the unit test suite
-* `npm run build` builds front end dependencies
-* `npm run watch` a watcher for webpack
+* `yarn run build` builds front-end dependencies
+* `yarn run watch` builds and watches front-end dependencies
+* `yarn test` runs front-end test suite
 
 ### Development inside Docker