Node.js Project Structure

🟢 Node.js LTS 📗 Chapter 5 of 49 📂 Phase 2: Setup & First Program 🗓️ 2026 Edition

📌 Covered in this chapter: package.json · node_modules · src Folder Layout · routes/controllers/services/models · .gitignore

Learn the standard folder layout used in real Node.js backend projects — package.json, src, routes, controllers, services, models and more.

1Node.js Project Structure — What You'll Learn

Learn the standard folder layout used in real Node.js backend projects — package.json, src, routes, controllers, services, models and more.

Here's everything this chapter covers, in the order you'll learn it:

package.json — your project's manifest
package-lock.json — exact dependency versions
node_modules — installed packages (never edit directly)
src folder for your source code
routes folder for endpoint definitions
controllers folder for request handlers
services folder for business logic
models folder for data structures
middleware folder for request pipeline functions
config folder for settings
tests folder for automated tests
.gitignore to exclude node_modules and secrets from Git

2Working Example

💻 Example: Node.js Project Structure

Text ▶ Run in Compiler

node-app/
├── src/
│   ├── app.js
│   ├── server.js
│   ├── routes/
│   ├── controllers/
│   ├── services/
│   ├── models/
│   ├── middleware/
│   └── config/
├── tests/
├── .env
├── .gitignore
├── package.json
└── package-lock.json

3Best Practices & Common Pitfalls

💡 Key things to remember:

Never commit node_modules or .env to Git — always add them to .gitignore.
This layered structure (routes → controllers → services → models) keeps your codebase testable and easy to navigate as it grows.

❓ Frequently Asked Questions (FAQ)

Q What's the most important thing to understand about node.js project structure?

Focus on: package.json · node_modules · src Folder Layout · routes/controllers/services/models · .gitignore. These are the core building blocks this chapter's examples are built around, and they show up repeatedly in later chapters of this course.

Q Do I need external npm packages for node.js project structure?

Only where explicitly shown in the code examples above (like Express, Zod, or Socket.IO) — otherwise, this chapter relies entirely on Node.js's own built-in capabilities.

Written by Our Compiler Technical Editorial Team
Reviewed for accuracy & tested on Node.js LTS · Last updated August 2026