DEV Community

Cover image for πŸš€ Getting Started with Node.js – from β€œWhat is this?” to your first web server
Ramanand Thakur
Ramanand Thakur

Posted on

πŸš€ Getting Started with Node.js – from β€œWhat is this?” to your first web server

Node.js lets us run JavaScript outside the browser. In this guide, we’ll install Node, learn the terminal, explore npm, build a real web server, understand event-driven programming, and serve static files β€” all before jumping into Express.js πŸ”₯


🧠 Why Node.js feels magical

In the previous article, we mentioned that JavaScript was designed to run only in browsers. Then Node.js came along, and suddenly everyone was like, β€œHold on… JavaScript can run on servers too?!”

Until then, JavaScript meant:

  • button clicks
  • animations
  • form validation
  • frontend headaches πŸ˜…

But with Node.js, suddenly JavaScript could:

  • read files
  • create APIs
  • talk to databases
  • stream videos
  • run backend servers

In this article, I’ll walk you through the exact beginner path I wish someone had shown me earlier.

By the end, you’ll:

βœ… Install Node.js
βœ… Understand the terminal without fear
βœ… Learn npm properly
βœ… Build your own Node server
βœ… Understand routing
βœ… Serve HTML/CSS files
βœ… Be fully ready for Express.js


πŸ“Œ Prerequisites

You only need:

  • Basic JavaScript knowledge
  • A laptop πŸ™‚
  • Node.js v20+ recommended
  • β˜• Coffee (strongly recommended)

🌍 What Exactly is Node.js?

Node.js is a JavaScript runtime built on Chrome’s V8 engine.

That means:

It allows JavaScript to run outside the browser.

Instead of running only inside Chrome or Firefox, JavaScript can now run directly on your computer or server.


πŸ“Š Browser JavaScript vs Node.js

Browser Javascript Vs Node.js


πŸ’» Getting Node.js

🟒 Step 1: Download Node

Visit:

Download the LTS version.

πŸ’‘ Production note: Always prefer the LTS (Long Term Support) version for stability.


🟒 Step 2: Verify Installation

Open terminal and run:

node -v
Enter fullscreen mode Exit fullscreen mode

Example output:

v20.11.0
Enter fullscreen mode Exit fullscreen mode

Now check npm:

npm -v
Enter fullscreen mode Exit fullscreen mode

Example:

10.2.4
Enter fullscreen mode Exit fullscreen mode

Boom πŸ’₯ Node installed successfully.


πŸ–₯️ Using the Terminal

We all were scared of it initially πŸ˜„

Most beginners avoid the terminal initially.

I did too.

Huge mistake.

The terminal is basically your direct communication line with the operating system.

Think of it like this:

GUI Terminal
Clicking buttons Typing commands
Slower Faster
Beginner friendly Developer powerful

πŸ“‚ Essential Terminal Commands

Windows

Use:

  • PowerShell
  • Windows Terminal

macOS/Linux

Use:

  • Terminal app

πŸ“Œ Most Useful Commands

# Show current folder
pwd

# List files
ls

# Change folder
cd folder-name

# Create folder
mkdir my-project

# Create file
touch app.js
Enter fullscreen mode Exit fullscreen mode

πŸ“Š Terminal Workflow

Terminal workflow


πŸ› οΈ Editors (VS Code or Claude)

You technically can write Node code in Notepad.

But please don’t torture yourself 😭.


🟦 VS Code (Recommended)

Visual Studio Code

Why developers love it:

  • Fast
  • Free
  • Great extensions
  • Git integration
  • Built-in terminal
  • Excellent Node support

πŸ”Œ Extensions I Recommend

Extension Why
ESLint Catch JavaScript mistakes
Prettier Auto formatting
Thunder Client API testing
GitLens Git superpowers

πŸ€– Claude Editor

Many developers also use:

Especially for:

  • debugging help
  • refactoring
  • documentation generation
  • learning concepts faster
  • vibe coding (We'll discuss this in detail in future articles)

But honestly?

VS Code + Node is still the gold standard for most beginners.


πŸ“¦ Understanding npm

npm stands for:

Node Package Manager

This is where Node becomes insanely powerful.

npm lets you install reusable packages instead of reinventing the wheel every time.


🧱 Create Your First Project

mkdir node-demo
cd node-demo
Enter fullscreen mode Exit fullscreen mode

Initialize project:

npm init -y
Enter fullscreen mode Exit fullscreen mode

This creates:

package.json
Enter fullscreen mode Exit fullscreen mode

πŸ“„ What is package.json?

Think of it like:

The Aadhaar card or identity card of your project πŸ˜„

It contains:

  • project name
  • dependencies
  • scripts
  • version
  • metadata

πŸ“Œ Example package.json

{
  "name": "node-demo",
  "version": "1.0.0",
  "main": "app.js"
}
Enter fullscreen mode Exit fullscreen mode

πŸ“Š How npm Works

NPM workflow


πŸš€ A Simple Web Server with Node.js

Now the fun part begins πŸ”₯


πŸ‘‹ Hello World Server

Create:

app.js
Enter fullscreen mode Exit fullscreen mode

βœ… Minimal Node Server

// Node.js v20

// Import Node's built-in HTTP module
const http = require('http');

// Create server
const server = http.createServer((request, response) => {

  // Send HTTP status code
  response.writeHead(200, {
    'Content-Type': 'text/plain'
  });

  // Send response body
  response.end('Hello World from Node.js πŸš€');
});

// Start listening on port 3000
server.listen(3000, () => {

  // Callback runs once server starts
  console.log('Server running at http://localhost:3000');

});
Enter fullscreen mode Exit fullscreen mode

▢️ Run the Server

node app.js
Enter fullscreen mode Exit fullscreen mode

Visit:

http://localhost:3000
Enter fullscreen mode Exit fullscreen mode

And there it is πŸŽ‰

Your first Node web server.


⚑ Understanding Event-Driven Programming

This is THE core Node concept.

And honestly?

This is where many folks get confused initially.


🧠 Traditional Programming

Traditional systems often wait for one task to finish before moving to the next.

Like standing in a railway booking queue πŸš‰.

One person at a time.


πŸš€ Node’s Event-Driven Model

Node works differently.

Instead of blocking everything:

  • it listens for events
  • processes callbacks
  • handles async tasks efficiently

πŸ“Š Event Loop Explained

Event loop diagram


πŸ“Œ Simple Event Example

// Node.js Events Module

const EventEmitter = require('events');

// Create event emitter instance
const emitter = new EventEmitter();

// Listen for custom event
emitter.on('orderPlaced', () => {

  console.log('πŸ• Pizza order received');

});

// Emit event
emitter.emit('orderPlaced');
Enter fullscreen mode Exit fullscreen mode

Output:

πŸ• Pizza order received
Enter fullscreen mode Exit fullscreen mode

🧭 Routing in Node.js

Routing means:

Sending different responses for different URLs.

Example:

URL Response
/ Home page
/about About page
/contact Contact page

βœ… Basic Routing Example

// app.js

const http = require('http');

const server = http.createServer((req, res) => {

  // Homepage route
  if (req.url === '/') {

    res.writeHead(200, {
      'Content-Type': 'text/plain'
    });

    res.end('🏠 Welcome Home');

  }

  // About page route
  else if (req.url === '/about') {

    res.writeHead(200, {
      'Content-Type': 'text/plain'
    });

    res.end('ℹ️ About Us');

  }

  // Fallback route
  else {

    res.writeHead(404, {
      'Content-Type': 'text/plain'
    });

    res.end('❌ Page Not Found');

  }

});

// Start server
server.listen(3000, () => {
  console.log('Server started');
});
Enter fullscreen mode Exit fullscreen mode

πŸ“Š How Routing Works

Routing workflow


πŸ“‚ Serving Static Resources

Static resources include:

  • HTML
  • CSS
  • JavaScript
  • Images

Without this, websites would look like 1998 πŸ˜….


πŸ“ Project Structure

project/
β”‚
β”œβ”€β”€ app.js
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html
β”‚   └── style.css
Enter fullscreen mode Exit fullscreen mode

βœ… Serve HTML File

// Node.js v20

const http = require('http');
const fs = require('fs');

const server = http.createServer((req, res) => {

  // Read HTML file
  fs.readFile('./public/index.html', (error, data) => {

    // Handle file read errors
    if (error) {

      res.writeHead(500);

      res.end('Internal Server Error');

      return;
    }

    // Send HTML response
    res.writeHead(200, {
      'Content-Type': 'text/html'
    });

    res.end(data);

  });

});

server.listen(3000);
Enter fullscreen mode Exit fullscreen mode

πŸ“„ Example HTML

<!DOCTYPE html>
<html>

<head>
  <title>Node Demo</title>
</head>

<body>

  <h1>πŸš€ Node.js Server</h1>

</body>
</html>
Enter fullscreen mode Exit fullscreen mode

🎨 Serve CSS File

// Simplified CSS serving example

if (req.url === '/style.css') {

  fs.readFile('./public/style.css', (err, data) => {

    res.writeHead(200, {
      'Content-Type': 'text/css'
    });

    res.end(data);

  });

}
Enter fullscreen mode Exit fullscreen mode

🀯 What Broke When I Tried This

TBH, many things πŸ˜‚


❌ Mistake 1: Wrong File Path

ENOENT: no such file or directory
Enter fullscreen mode Exit fullscreen mode

βœ… Fix

Always verify folder structure carefully.


❌ Mistake 2: Port Already in Use

EADDRINUSE
Enter fullscreen mode Exit fullscreen mode

βœ… Fix

Another app is using the same port.

Simply, change the port number. (3000 to something else which is not getting used πŸ˜„)


❌ Mistake 3: Browser Keeps Loading Forever

Usually happens because:

res.end()
Enter fullscreen mode Exit fullscreen mode

was forgotten.


πŸ“ˆ Why Express.js Was Needed

After writing enough raw Node servers, developers realized:

β€œDude… this is becoming repetitive.”

Things became messy quickly:

  • manual routing
  • manual headers
  • repetitive file handling
  • middleware chaos

That’s exactly why Express.js became popular.


πŸ“Š Raw Node vs Express

Node vs Express

Express dramatically reduced boilerplate code.


β˜• Caffeine Scale

Topic Complexity
Installing Node β˜•
npm basics β˜•β˜•
Routing β˜•β˜•
Event loop β˜•β˜•β˜•β˜•

🎯 Onward to Express.js

Now you understand:

βœ… Node installation
βœ… Terminal basics
βœ… npm
βœ… HTTP servers
βœ… Event-driven programming
βœ… Routing
βœ… Static files

You’re officially ready for:

πŸš€ Express.js

But don’t worry β€” if you missed anything, we’ll come back to some of these topics individually and go way deeper πŸš€

And trust me…

Once you use Express routing after raw Node routing, it feels like upgrading from manual gear driving to automatic πŸ˜„


πŸ“Œ Key Takeaways

  • Node.js lets JavaScript run outside browsers
  • npm powers the massive Node ecosystem
  • Node uses event-driven architecture
  • You can build web servers with built-in modules
  • Routing and static file serving are fundamental backend concepts
  • Express simplifies all of this beautifully

πŸ“’ What’s Next?

In the next article we’ll cover:

  • Scaffolding
  • Installing Express
  • Request/response lifecycle
  • Middleware

πŸ’¬ Your Turn

What confused you most when learning Node?

  • npm?
  • terminal?
  • async programming?
  • routing?

And did you also use incorrect file path at least once? πŸ˜…


πŸ“£ Call To Action

If this article helped you:

  • ⭐ Bookmark it
  • πŸ” Share with a beginner developer
  • πŸš€ Build your own tiny Node server today
  • πŸ‘¨β€πŸ’» Follow for more backend deep dives

Top comments (0)