#Environment Setup

#Overview

Setting up a proper development environment is crucial for Node.js development. This chapter will guide you through installing Node.js, NPM, and essential development tools.

#Installing Node.js

#Option 1: Official Installer (Recommended for Beginners)

1. Visit nodejs.org
2. Download the LTS (Long Term Support) version
3. Run the installer and follow the setup wizard
4. Verify installation:

node --version
npm --version

#Option 2: Using Node Version Manager (NVM)

NVM allows you to install and switch between multiple Node.js versions.

#On macOS/Linux:

# Install NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# Restart terminal or run:
source ~/.bashrc

# Install latest LTS Node.js
nvm install --lts
nvm use --lts

#On Windows:

# Install nvm-windows from GitHub releases
# Then use PowerShell:
nvm install lts
nvm use lts

#Option 3: Using Package Managers

#macOS (Homebrew):

brew install node

#Ubuntu/Debian:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

#Windows (Chocolatey):

choco install nodejs

#Understanding NPM

NPM (Node Package Manager) comes bundled with Node.js and serves multiple purposes:

• Package Manager: Install and manage dependencies
• Script Runner: Run custom scripts defined in package.json
• Registry: Access to over 1 million packages

#Basic NPM Commands

# Check NPM version
npm --version

# Initialize a new project
npm init

# Install a package locally
npm install express

# Install a package globally
npm install -g nodemon

# Install development dependencies
npm install --save-dev jest

# Update packages
npm update

# List installed packages
npm list

#Essential Development Tools

#1. Code Editor

Visual Studio Code (Recommended)

• Download from code.visualstudio.com
• Install Node.js extensions:
  • Node.js Extension Pack
  • ESLint
  • Prettier
  • REST Client

#2. Nodemon (Development Server)

Automatically restarts your application when files change:

# Install globally
npm install -g nodemon

# Use instead of node
nodemon app.js

#3. Git Version Control

# Install Git
# Windows: Download from git-scm.com
# macOS: brew install git
# Linux: sudo apt install git

# Configure Git
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

#Project Structure Setup

#Creating Your First Project

# Create project directory
mkdir my-node-app
cd my-node-app

# Initialize NPM project
npm init -y

# Create basic files
touch app.js
touch .gitignore

#Basic package.json Structure

{
  "name": "my-node-app",
  "version": "1.0.0",
  "description": "My first Node.js application",
  "main": "app.js",
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "jest"
  },
  "keywords": ["nodejs", "javascript"],
  "author": "Your Name",
  "license": "MIT",
  "dependencies": {},
  "devDependencies": {}
}

#Essential .gitignore

# Dependencies
node_modules/
npm-debug.log*

# Environment variables
.env
.env.local
.env.production

# Logs
logs/
*.log

# Runtime data
pids/
*.pid
*.seed

# Coverage directory used by tools like istanbul
coverage/

# IDE files
.vscode/
.idea/
*.swp
*.swo

# OS generated files
.DS_Store
Thumbs.db

#Environment Variables

#Using dotenv Package

npm install dotenv

Create .env file:

PORT=3000
DATABASE_URL=mongodb://localhost:27017/myapp
API_KEY=your-secret-api-key

Load in your application:

require('dotenv').config();

const port = process.env.PORT || 3000;
const dbUrl = process.env.DATABASE_URL;

#Development Workflow Setup

#1. ESLint (Code Linting)

npm install --save-dev eslint
npx eslint --init

#2. Prettier (Code Formatting)

npm install --save-dev prettier

Create .prettierrc:

{
  "semi": true,
  "trailingComma": "es5",
  "singleQuote": true,
  "printWidth": 80,
  "tabWidth": 2
}

#3. Package Scripts

Update package.json scripts:

{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "jest",
    "lint": "eslint .",
    "format": "prettier --write ."
  }
}

#Debugging Setup

#VS Code Debugging Configuration

Create .vscode/launch.json:

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/app.js",
      "env": {
        "NODE_ENV": "development"
      }
    }
  ]
}

#Node.js Inspector

# Start with debugger
node --inspect app.js

# Or with nodemon
nodemon --inspect app.js

#Verification Test

Create a simple test file to verify your setup:

// app.js
console.log('Node.js version:', process.version);
console.log('NPM version:', process.env.npm_version);
console.log('Environment setup complete!');

// Test async operation
setTimeout(() => {
  console.log('Async operation working!');
}, 1000);

Run the test:

node app.js

#Troubleshooting Common Issues

#Permission Issues (macOS/Linux)

# Fix NPM permissions
sudo chown -R $(whoami) ~/.npm

#Path Issues (Windows)

• Ensure Node.js is added to system PATH
• Restart command prompt after installation

#Version Conflicts

# Clear NPM cache
npm cache clean --force

# Reinstall Node.js if needed

#Next Steps

Now that your environment is set up, we'll create your first Node.js application in the next chapter.

#Practice Exercise

1. Install Node.js and verify the installation
2. Create a new project with npm init
3. Install nodemon globally
4. Create a simple "Hello World" application
5. Set up ESLint and Prettier

#Key Takeaways

• Multiple ways to install Node.js (official installer, NVM, package managers)
• NPM is essential for package management and script running
• Proper project structure and tooling improve development experience
• Environment variables help manage configuration
• Development tools like nodemon, ESLint, and Prettier enhance productivity