diff --git a/npm/README.md b/npm/README.md
index cec7e5e..00cbdc3 100644
--- a/npm/README.md
+++ b/npm/README.md
@@ -1,29 +1,10 @@
-
+# 📦✨ wasm-pack
+> Your favorite rust -> wasm workflow tool!
-
📦✨ wasm-pack
+[](https://travis-ci.com/rustwasm/wasm-pack)
+[](https://ci.appveyor.com/project/ashleygwilliams/wasm-pack-071k0)
+[](https://crates.io/crates/wasm-pack)
-
- Your favorite Rust → Wasm workflow tool!
-
-
-
-
-
-
-
-
-
-
-
Built with 🦀🕸 by The Rust and WebAssembly Working Group
-
-
-## About
This tool seeks to be a one-stop shop for building and working with rust-
generated WebAssembly that you would like to interop with JavaScript, in the
@@ -49,23 +30,17 @@ This project requires Rust 1.30.0 or later.
- [Development Environment](https://rustwasm.github.io/wasm-pack/book/prerequisites/index.html)
- [Installation](https://rustwasm.github.io/wasm-pack/installer)
-
-## ⚡ Quickstart Guide
-
-Visit the [quickstart quide] in our documentation.
-
-[quickstart guide]: https://rustwasm.github.io/wasm-pack/book/quickstart.html
+- [Project Setup](https://rustwasm.github.io/wasm-pack/book/project-setup/index.html)
## 🎙️ Commands
-- [`new`](https://rustwasm.github.io/wasm-pack/book/commands/new.html): Generate a new RustWasm project using a template
- [`build`](https://rustwasm.github.io/wasm-pack/book/commands/build.html): Generate an npm wasm pkg from a rustwasm crate
- [`test`](https://rustwasm.github.io/wasm-pack/book/commands/test.html): Run browser tests
- [`pack` and `publish`](https://rustwasm.github.io/wasm-pack/book/commands/pack-and-publish.html): Create a tarball of your rustwasm pkg and/or publish to a registry
## 📝 Logging
-`wasm-pack` uses [`env_logger`] to produce logs when `wasm-pack` runs.
+`wasm-pack` uses [`env_logger`] to produces logs when `wasm-pack` runs.
To configure your log level, use the `RUST_LOG` environment variable. For example:
@@ -89,6 +64,40 @@ This project is part of the [rustwasm Working Group].
This project was started by [ashleygwilliams] and is co-maintained by [ashleygwilliams], [drager] and the Rust Wasm Working Group Core Team.
-[ashleygwilliams]: https://github.com/ashleygwilliams
-[drager]: https://github.com/drager
-[rustwasm Working Group]: https://github.com/rustwasm/team
+## ⚡ Quickstart Guide
+
+1. Write a crate in Rust.
+2. Add `wasm-bindgen` to your `Cargo.toml`:
+
+ ```toml
+ [lib]
+ crate-type = ["cdylib"]
+
+ [dependencies]
+ wasm-bindgen = "0.2"
+ ```
+3. Add this to the top of your `src/lib.rs`:
+
+ ```rust
+ use wasm_bindgen::prelude::*;
+ ```
+
+4. Annotate your public functions with `#[wasm_bindgen]`, for example:
+
+ ```rust
+ #[wasm_bindgen]
+ extern {
+ pub fn alert(s: &str);
+ }
+
+ #[wasm_bindgen]
+ pub fn greet(name: &str) {
+ alert(&format!("Hello, {}!", name));
+ }
+ ```
+
+5. Install this tool: `cargo install wasm-pack`
+6. Run `wasm-pack build`, optionally, pass a path to a dir or a scope (see above for details)
+7. This tool generates files in a `pkg` dir
+8. To publish to npm, run `wasm-pack publish`. You may need to login to the
+ registry you want to publish to. You can login using `wasm-pack login`.
\ No newline at end of file