Node.js et npm - Les fondamentaux

Bienvenue ! Avant de commencer à construire des applications avec Next.js, tu dois installer deux outils essentiels : Node.js et npm.

Qu'est-ce que Node.js ?

Node.js est un environnement d'exécution JavaScript en dehors du navigateur. Grâce à lui, tu peux exécuter du code JavaScript sur ton ordinateur, et pas seulement dans le navigateur.

Pourquoi Node.js est-il important ?

• Faire tourner Next.js nécessite Node.js
• Installer des paquets (bibliothèques)
• Outils de développement (build tools)
• Serveur de développement (localhost)

Qu'est-ce que npm ?

npm (Node Package Manager) est un gestionnaire de paquets pour JavaScript. Il te permet d'installer des bibliothèques et des outils créés par d'autres développeurs.

Exemples de paquets npm :

• react - bibliothèque pour construire des interfaces
• next - framework Next.js
• tailwindcss - framework CSS
• Et des millions d'autres...

Installer Node.js et npm

Node.js et npm s'installent ensemble - un seul installateur, deux outils.

Étape 1 : Télécharger l'installateur

1. Va sur : https://nodejs.org et clique sur Get Node.js®
2. Sur la page de téléchargement, garde dans le menu la version marquée LTS (Long Term Support, v24 aujourd'hui) ← Choisis celle-ci ! La version Current (v26 aujourd'hui) a les dernières fonctionnalités, mais un support plus court.
3. Plus bas, dans la partie « Or get a prebuilt Node.js® », clique sur le bouton de l'installateur pour ton système (Windows : .msi, macOS : .pkg)

Étape 2 : Installer

Windows :

• Double-clique sur le fichier .msi
• Clique sur « Next » → « Next » → « Install »
• Attends ~1-2 minutes

Mac :

• Double-clique sur le fichier .pkg
• Clique sur « Continue » → « Install »
• Attends ~1-2 minutes

Linux (Ubuntu/Debian) :

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

Étape 3 : Vérification

Ouvre le terminal dans Cursor (Ctrl + `, aussi Control sur Mac, pas Cmd) et tape :

1node --version

Tu devrais voir quelque chose comme : v24.21.0 (la version LTS actuelle). Next.js 16 demande au moins la version 20.9.

Vérifie npm :

1npm --version

Tu devrais voir quelque chose comme : 11.19.0 (le npm fourni avec Node.js 24).

Si tu vois des numéros de version - félicitations ! Node.js et npm sont installés.

Commandes npm de base

Maintenant que tu as npm, tu peux installer des paquets et lancer des projets.

1. npm install - Installer des paquets

Quand tu ouvres un projet Next.js existant, la première étape consiste à installer les dépendances :

1npm install

Cela télécharge toutes les bibliothèques listées dans package.json.

2. npm run dev - Serveur de développement

Cela démarre le serveur de développement de Next.js :

1npm run dev

Ensuite, ton application sera disponible à l'adresse http://localhost:3000

3. npm run build - Compiler pour la production

Cela prépare l'application pour le déploiement :

1npm run build

4. npx - Lancer des outils sans installation

npx te permet de lancer des outils sans installation globale :

1npx create-next-app@latest

Cela va créer un nouveau projet Next.js.

package.json - Le cœur du projet

Chaque projet JavaScript possède un fichier package.json - c'est comme la carte d'identité du projet.

Il contient :

• Le nom du projet
• La liste des dépendances
• Les scripts - les commandes npm
• Les métadonnées (auteur, description, licence)

Exemple de package.json :

1{
2  "name": "krakens-call",
3  "version": "0.1.0",
4  "private": true,
5  "scripts": {
6    "dev": "next dev",
7    "build": "next build",
8    "start": "next start",
9    "lint": "eslint"
10  },
11  "dependencies": {
12    "next": "16.3.8",
13    "react": "19.2.8",
14    "react-dom": "19.2.8"
15  }
16}

Les scripts sont des commandes que tu peux lancer via npm run :

• npm run dev → lance next dev
• npm run build → lance next build

node_modules - Le dossier des bibliothèques

Quand tu lances npm install, npm crée un dossier node_modules avec tous les paquets installés.

IMPORTANT :

• node_modules peut faire des centaines de Mo ou plus
• NE PAS commiter node_modules dans Git
• Ajoute node_modules/ à .gitignore
• Chaque personne télécharge le projet et lance npm install

Résumé

Node.js - environnement d'exécution pour JavaScript npm - gestionnaire de paquets package.json - liste des dépendances et des scripts node_modules - dossier avec les paquets installés npm install - installe les dépendances npm run dev - démarre le serveur de développement npx - lance des outils sans installation

Dans le prochain exercice, nous allons créer notre premier projet Next.js !

À tout de suite !