From ebc306a67332323b74d8109e9c3379024e903615 Mon Sep 17 00:00:00 2001 From: Matthew Taylor Date: Wed, 2 Dec 2015 17:13:33 -0500 Subject: [PATCH] Add some extra info to readme 1. note on installing node/npm before getting started 2. note emphasizing that default setup means pointing to real data on the Scratch website. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index a92481006..aa09b0e58 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,9 @@ [![Build Status](https://magnum.travis-ci.com/LLK/scratch-www.svg?token=xzzHj4ct3SyBTpeqxnx1)](https://magnum.travis-ci.com/LLK/scratch-www) +### Before Getting Started +* make sure you have npm [installed](https://docs.npmjs.com/getting-started/installing-node) + ### To Build ```bash npm install @@ -16,6 +19,10 @@ npm start During development, `npm start` watches any update you make to files in either `./static` or `./src` and triggers a rebuild of the project. In development the build is stored in memory, and not served from the `./build` directory. +When running `npm start`, here are some important log messages to keep an eye out for: +* `webpack: bundle is now VALID.` – the bundle has been loaded into memory and is now viewable in the browser. This will show up both once `npm start` has completed its setup, and also once updates you make to files have been re-compiled for viewing in the browser. +* `webpack: bundle is now INVALID.` – if you see this, then it means you have made updates to files that are still being compiled for browser viewing. Pages will still be viewable, but they will not see any updates you made yet. + Once running, open `http://localhost:8333` in your browser. If you wish to have the server reload automatically, you can install either [nodemon](https://github.com/remy/nodemon) or [forever](https://github.com/foreverjs/forever). ### To stop @@ -32,6 +39,8 @@ Use `^C` to stop the node process `npm start` starts. | `PORT` | `8333` | Port for devserver (http://localhost:XXXX) | | `FALLBACK` | `''` | Pass-through location for scratchr2 | +**NOTE:** Because by default both `API_HOST=https://api.scratch.mit.edu` and `PROXY_HOST=https://scratch.mit.edu`, please be aware that, by default, you will be seeing and interacting with real data on the Scratch website. + ### To Test ```bash npm test