Skip to content

Node.js for Mere Mortals

Plain-language guides to Node.js — JavaScript outside the browser — written for people who want to build servers, CLIs, and tools without a CS degree.

No jargon without an explanation. No "it's simple, just..." Every concept starts with the idea, then the code.

One honest note up front: JavaScript is a quirky language with 30 years of history baked in — == vs ===, two module systems, this behaving oddly. Node doesn't fix the quirks; it just gives the language a fast engine and a huge library ecosystem. These guides teach the modern, sane subset and warn you about the traps.

Start here

  1. What Node.js Is — what it is, where it lives, and why learn it.
  2. Installing Node.js — version managers, installers, and checks that it worked.
  3. Your First Program — running a script, reading files, with checks along the way.

The building blocks

  1. Variables and Types — let, const, and the === rule.
  2. Control Flow — if, loops, and switch.
  3. Functions — declarations, arrows, and callbacks.
  4. Async JavaScript — promises, async/await, and the event loop. The heart of Node.
  5. Modules and npm — sharing code and the package ecosystem.
  6. Error Handling — try/catch, rejections, and what crashes the process.

Reference

  1. Troubleshooting — error messages and common gotchas, plain fixes.
  2. Glossary — quick definitions, A to Z.

Writing criteria

Every guide follows the same writing criteria: plain words, no hype, honest limits, and checkable steps.