Node.js Tutorial: Build Your First App – Beginner Guide

Imagine you’ve just opened your laptop, typed node -v and saw “v20.12.0” flashing back at you. The terminal is humming, but you still wonder: “What’s the fastest way to turn this into a real web app?” That moment of curiosity is the perfect launchpad for a beginner‑friendly Node.js tutorial.

In This Article

• Setting Up the Development Environment
• Creating Your First Node.js Project
• Understanding Core Modules
• Building a Simple HTTP Server
• Implementing Routing with Express
• Working with Databases
• Testing and Debugging
• Deploying Your App

Setting Up the Development Environment

First things first: you need a stable Node.js runtime and a code editor you enjoy. For most beginners, the LTS (Long‑Term Support) version from nodejs.org is the safest bet. Install it, then run node -v and npm -v to confirm both are available. VS Code is a popular free editor; its built‑in terminal lets you stay in one window while you code.

Tip: If you plan to switch Node versions later, install nvm (Node Version Manager) on macOS/Linux or nvm-windows. It lets you test your app against multiple runtimes without reinstalling.

Creating Your First Node.js Project

Open a fresh folder, then run npm init -y. This command creates a package.json file with default values, which you’ll edit as the project grows. The scripts section is where you’ll add shortcuts like "start": "node index.js". Create an index.js file and add a simple console log:

console.log('Hello, Node!');

Run npm start and watch the message appear. You’ve just built the skeleton of a Node.js app.

Understanding Core Modules

Node ships with dozens of built‑in modules that let you interact with the file system, network, and more. The fs module, for example, reads and writes files without any external dependency:

const fs = require('fs');
fs.readFile('package.json', 'utf8', (err, data) => {
  if (err) throw err;
  console.log(JSON.parse(data).name);
});

Notice the use of require, the CommonJS syntax that Node has used for years. Starting with Node 12, you can also use ES modules by adding “type”: “module” to package.json and swapping require for import. Both work, but keep consistency across your codebase.

Building a Simple HTTP Server

Before you reach for a framework, try the native http module. It’s only a handful of lines, yet it shows how requests and responses flow:

const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Welcome to your first Node server!');
});
server.listen(3000, () => console.log('Server running on http://localhost:3000'));

Visit http://localhost:3000 and you’ll see the greeting. This exercise reinforces the event‑driven nature of Node: each request triggers a callback, keeping the thread free for other work.

Implementing Routing with Express

Most real‑world apps need routing, templating, and middleware. Express is the de‑facto framework that adds these features with minimal overhead. Install it with npm install express, then replace the previous server code:

const express = require('express');
const app = express();
app.get('/', (req, res) => res.send('Home page'));
app.get('/about', (req, res) => res.send('About us'));
app.listen(3000, () => console.log('Express listening on port 3000'));

Notice the clean app.get syntax—no manual header handling. You can also serve static files with app.use(express.static('public')), which is handy for CSS, images, and client‑side JavaScript.

Working with Databases

Data persistence is the next step. For beginners, SQLite offers a zero‑configuration file‑based database, while MongoDB provides a flexible document model. Here’s a quick example using the sqlite3 package:

npm install sqlite3
const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database('./data.db');
db.serialize(() => {
  db.run('CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT)');
  db.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
  db.each('SELECT * FROM users', (err, row) => console.log(row));
});

If you prefer a NoSQL approach, install mongoose and connect to a free MongoDB Atlas cluster. The key is to keep the database logic separate from route handlers, typically in a models/ folder.

Testing and Debugging

Node’s built‑in debugger works with node --inspect index.js, and Chrome DevTools can attach to that session. For automated testing, Jest and Mocha are popular choices. A simple Jest test for a utility function looks like this:

npm install --save-dev jest
// sum.js
function sum(a, b) { return a + b; }
module.exports = sum;
// sum.test.js
const sum = require('./sum');
test('adds 1 + 2 to equal 3', () => {
  expect(sum(1, 2)).toBe(3);
});

Run npm test and watch the green checkmark. Writing a few unit tests early saves countless hours when the codebase expands.

Deploying Your App

When you’re ready to share your work, platforms like Vercel, Render, and Heroku offer free tiers for Node.js. The deployment steps are usually:

1. Push your code to GitHub.
2. Connect the repo to the hosting service.
3. Set the start script (e.g., npm start) in the dashboard.
4. Configure environment variables for secrets (API keys, DB URLs).

Most services automatically install dependencies and start your app on a dynamic port, which you can read via process.env.PORT || 3000. Remember to bind to that variable; otherwise the app will crash on the host.

Conclusion

From a single node -v check to a live URL, you’ve walked through the essential steps of building a Node.js app as a beginner. The journey teaches you how the runtime works, how to structure code, and where to find the tools that keep development smooth. Keep experimenting—swap Express for Koa, try TypeScript, or connect to a GraphQL API. The more you tinker, the deeper your understanding becomes.

Frequently Asked Questions

How do I install Node.js on Windows, macOS, and Linux?

Download the installer from nodejs.org for Windows or macOS, or use a package manager like apt (Ubuntu), brew (macOS), or nvm for any Unix‑like system. Verify the installation with node -v and npm -v.

What is the difference between CommonJS and ES modules in Node.js?

CommonJS uses require and module.exports, while ES modules use import and export. ES modules need “type”: “module” in package.json> or a .mjs extension. Both are supported, but mixing them can cause errors, so pick one style per project.