Accompanying code samples and snippets for the JavaScript Application Design: A Build First Approach book.

This are the accompanying code samples and snippets for a book I wrote about JavaScript build processes and application architecture. The samples are organized by chapter, and they appear in the same order as they do in the book, for convenience. Many other resources for this book are listed in its website, such as links to blog posts, articles, essays, books, and any other particularly relevant topics discussed throughout the book.

You could visit its landing page to learn all about it!

Book buying frenzy? Say no more, stranger!

We need git, to clone the repository like below.

cd /dev/repo
git clone --recursive https://github.com/bevacqua/buildfirst.git

The --recursive flag is used to clone submodules as well. Read a bit more about this command, for context.

As an alternative, we can use a little utility developed by GitHub, called hub, to make cloning repositories a bit easier. It's just less verbose to type by hand, useful if you use the terminal a lot.

cd /dev/repo
hub clone --recursive bevacqua/buildfirst

You'll need Node.js, refer to this link to install it. It comes with the node and npm command-line tools.

You will need to install dependencies for most of the examples using npm install. This command has to be run on each sample's directory. To relive you of this burden, you can use one of the following commands to install the packages in all of them at once. Note that you'll need to cd to the root of the samples directory for this to work.

cd buildfirst

Then, use the command that fits your OS, from the options below.

We can use the find program.

find . -mindepth 2 -maxdepth 2 -type d -name '*_*' -print -exec npm install --prefix {} \;

Note that this might take a while.

Try this command, although it hasn't been tested. Let me know if it works!

for /d . %d in (ch*\*_*) do @if exist "%d" npm install --prefix %d

That's it! You are now free to roam the sample directories and follow the instructions in each of them!

To run an example, read its README.md and follow the instructions I've placed there. I tried to make them as straightforward as possible, but sometimes they might not match the examples in the book to the letter.

There are some examples here that you won't find on the book, those will generally be a bit longer: exactly the reason why I didn't include them in the book. Although the code itself might not be present in the book, most of the explaining will definitely be there, rather than here.

This is the list of releases to date. You can feel free to simply clone master, to get the most up-to-date version.

• One Third Review

You can find the repository up on GitHub, which contains the latest updates to the samples, and interactively renders the Markdown code in this text, displaying images, making code prettier, styling the text, and letting you follow links.

If you run into any problems, please create an issue here. Maybe it's something that needs fixing. If you feel like contributing, that's awesome! Just fork this repo and create a pull request with your fixes or improvements.

You can drop me a line at [email protected] if you want to leave me feedback, say hi, or grunt at me about my failure to amuse you. I'd love to hear from you!

I'm also reachable through my blog, I'm @nzgb on Twitter, and I enjoy people stalking me over the Internet.

Let the #buildfirst revolution commence!