diff --git a/README.md b/README.md
index 98ae581..ae663d3 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,84 @@
Build a Nucleus
-================
-
+=============
"Build a Nucleus" is an educational simulation in HTML5, by PhET Interactive Simulations
at the University of Colorado Boulder.
+For a description of this simulation, associated resources, and a link to the published version,
+visit the simulation's web page.
+
+### Try it!
-*This simulation is under development and has not been published.*
+Click here to run "Build a Nucleus".
+
+
+
+
### Documentation
The PhET Development Overview is the most complete guide to PhET Simulation
Development. This guide includes how to obtain simulation code and its dependencies, notes about architecture & design, how to test and build
the sims, as well as other important information.
+### Quick Start
+(1) Clone the simulation and its dependencies:
+```
+git clone https://github.com/phetsims/assert.git
+git clone https://github.com/phetsims/axon.git
+git clone https://github.com/phetsims/babel.git
+git clone https://github.com/phetsims/bamboo.git
+git clone https://github.com/phetsims/brand.git
+git clone https://github.com/phetsims/build-a-nucleus.git
+git clone https://github.com/phetsims/build-an-atom.git
+git clone https://github.com/phetsims/chipper.git
+git clone https://github.com/phetsims/dot.git
+git clone https://github.com/phetsims/joist.git
+git clone https://github.com/phetsims/kite.git
+git clone https://github.com/phetsims/perennial.git perennial-alias
+git clone https://github.com/phetsims/phet-core.git
+git clone https://github.com/phetsims/phetcommon.git
+git clone https://github.com/phetsims/phetmarks.git
+git clone https://github.com/phetsims/query-string-machine.git
+git clone https://github.com/phetsims/scenery.git
+git clone https://github.com/phetsims/scenery-phet.git
+git clone https://github.com/phetsims/sherpa.git
+git clone https://github.com/phetsims/shred.git
+git clone https://github.com/phetsims/sun.git
+git clone https://github.com/phetsims/tambo.git
+git clone https://github.com/phetsims/tandem.git
+git clone https://github.com/phetsims/twixt.git
+git clone https://github.com/phetsims/utterance-queue.git
+```
+
+(2) Install dev dependencies:
+```
+cd chipper
+npm install
+cd ../perennial-alias
+npm install
+cd ../build-a-nucleus
+npm install
+```
+
+(3) Change directory to chipper `cd ../chipper/`, then transpile the code to JavaScript by running `node js/scripts/transpile.js --watch`. This starts a file-watching process
+that will automatically transpile new or changed files.
+
+(4) In a new terminal/command prompt, start an http-server
+
+(5) Open in the browser: `http://localhost/build-a-nucleus/build-a-nucleus_en.html` (You will probably need to modify this URL based on your HTTP port and relative path.)
+
+#### Optional: Build the simulation into a single file
+
+(1) Change directory to the simulation directory: `cd ../build-a-nucleus`
+
+(2) Build the sim: `grunt --brands=adapted-from-phet`. It is safe to ignore warnings like `>> WARNING404: Skipping potentially non-public dependency`,
+which indicate that non-public PhET-iO code is not being included in the build.
+
+(3) Open in the browser: `http://localhost/build-a-nucleus/build/adapted-from-phet/build-a-nucleus_en_adapted-from-phet.html` (You will probably need to modify this URL based on your HTTP port and relative path.)
+
+### Get Involved
+
+Contact us at our Google Group: Developing Interactive Simulations in HTML5
+
+Help us improve, create a New Issue
+
### License
See the LICENSE