Skip to content
Learni
Voir tous les tutoriels
Architecture

Comment configurer Turborepo pour un monorepo en 2026

12 minINTERMEDIATE
MonorepoTurborepo
Read in English

Introduction

Turborepo permet de gérer des monorepos complexes avec des builds rapides grâce à la mise en cache et l'exécution parallèle des tâches. En 2026, il reste l'outil de référence pour les équipes qui veulent scaler leurs applications sans sacrifier les performances. Ce tutoriel vous guide pas à pas dans la configuration d'un monorepo avec plusieurs applications et packages partagés.

Prérequis

  • Node.js 20+
  • npm ou pnpm
  • Connaissances de base en TypeScript et monorepos
  • Un terminal et un éditeur de code

Initialiser le monorepo

terminal
npx create-turbo@latest my-turborepo --yes
cd my-turborepo

Cette commande crée la structure de base avec un dossier apps et packages. Le flag --yes accepte les valeurs par défaut pour un démarrage rapide.

Configurer turbo.json

turbo.json
{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**"]
    },
    "dev": {
      "persistent": true,
      "cache": false
    },
    "lint": {
      "dependsOn": ["^lint"]
    }
  }
}

Le fichier turbo.json définit les pipelines. Les dépendances ^build garantissent que les packages sont construits avant les apps qui en dépendent.

Ajouter un package partagé

packages/ui/package.json
{
  "name": "@repo/ui",
  "version": "0.0.0",
  "private": true,
  "exports": {
    "./button": "./src/button.tsx"
  },
  "scripts": {
    "build": "tsc",
    "lint": "eslint ."
  }
}

Ce package exporte des composants réutilisables. Le scope @repo facilite les imports dans les autres workspaces.

Mettre à jour les scripts racine

package.json
{
  "name": "my-turborepo",
  "private": true,
  "scripts": {
    "build": "turbo run build",
    "dev": "turbo run dev",
    "lint": "turbo run lint"
  },
  "devDependencies": {
    "turbo": "latest"
  }
}

Les scripts racine délèguent l'exécution à Turbo pour bénéficier du cache et du parallélisme automatique.

Lancer le build complet

terminal
npm run build

Turbo exécute les tâches en parallèle, réutilise le cache quand possible et affiche un résumé clair des résultats.

Bonnes pratiques

  • Toujours déclarer les outputs dans turbo.json pour activer le cache
  • Utiliser des scopes @repo pour les packages internes
  • Configurer les tâches persistantes (dev) avec persistent: true
  • Exécuter turbo avec --filter pour cibler des packages spécifiques
  • Mettre à jour régulièrement la version de Turbo

Erreurs courantes à éviter

  • Oublier de déclarer les dépendances ^build dans turbo.json
  • Ne pas exclure node_modules des outputs
  • Lancer les commandes npm directement au lieu de turbo
  • Ignorer les erreurs de cache corrompu (utiliser turbo clean)

Pour aller plus loin

Découvrez nos formations avancées sur les monorepos et Turborepo sur Learni Group.