Installation de NestJS

Les quatre étapes, de Node.js au premier « Hello World! ».

Étape 1 : vérifier les prérequis

node -v     # version LTS récente (20 ou plus)
npm -v
git --version

Si une commande n'est pas reconnue, reprenez la leçon 2.1 (Node.js) ou installez Git depuis git-scm.com.

Étape 2 : installer la CLI Nest

La CLI Nest (Command Line Interface) est l'outil qui crée les projets et génère le code. On l'installe globalement pour pouvoir utiliser la commande nest partout :

npm install -g @nestjs/cli
nest --version

Sous Linux ou macOS, si une erreur de permissions apparaît, utilisez nvm (leçon 2.1) plutôt que sudo.

Étape 3 : créer un projet

Placez-vous dans votre dossier de travail (par exemple Documents/nestjs) :

nest new api-stagiaires

La CLI demande le gestionnaire de paquets : choisissez npm avec les flèches puis Entrée. Elle crée le dossier, les fichiers de départ, installe les dépendances et initialise un dépôt Git. L'opération prend une à deux minutes.

api-stagiaires/
├── src/
│   ├── app.controller.ts       ← contrôleur racine (route GET /)
│   ├── app.controller.spec.ts  ← test unitaire du contrôleur
│   ├── app.module.ts           ← module racine
│   ├── app.service.ts          ← service racine
│   └── main.ts                 ← point d'entrée : démarre le serveur
├── test/                       ← tests end-to-end
├── nest-cli.json               ← configuration de la CLI
├── package.json
├── tsconfig.json               ← configuration TypeScript
└── .gitignore

Étape 4 : lancer l'application

cd api-stagiaires
npm run start:dev

Le mode start:dev compile le TypeScript et redémarre automatiquement à chaque enregistrement. Le terminal affiche les modules chargés et les routes détectées :

[Nest] LOG [NestFactory] Starting Nest application...
[Nest] LOG [InstanceLoader] AppModule dependencies initialized
[Nest] LOG [RoutesResolver] AppController {/}:
[Nest] LOG [RouterExplorer] Mapped {/, GET} route
[Nest] LOG [NestApplication] Nest application successfully started

Ouvrez http://localhost:3000 : la page affiche Hello World!. Ce texte vient de la méthode getHello() de app.service.ts, appelée par app.controller.ts.

Pour arrêter le serveur : Ctrl+C dans le terminal.

Erreurs fréquentes

Changer le port

// src/main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(process.env.PORT ?? 3000);   // 3000 par défaut
}
bootstrap();

Publier le projet sur GitHub

Dès le premier jour, votre travail doit être sauvegardé et visible sur GitHub. Créez sur github.com/new un dépôt vide nommé api-stagiaires (sans README ni .gitignore), puis :

git add .
git commit -m "Création du projet NestJS"
git branch -M main
git remote add origin https://github.com/VOTRE-COMPTE/api-stagiaires.git
git push -u origin main

Activités