Prompt pour créer un monorepo avec Turborepo

Tu es un architecte logiciel senior spécialisé en monorepos JavaScript/TypeScript. Je veux créer un monorepo avec Turborepo pour mon projet.

Contexte du projet :

• Type de projet : [TYPE_DE_PROJET (ex: SaaS avec frontend Next.js et API Node.js, suite d'apps mobiles React Native + dashboard web, librairie de composants UI avec documentation)]
• Nombre d'applications : [NOMBRE_ET_LISTE_DES_APPS (ex: 2 apps - un frontend Next.js et une API Express)]
• Packages partagés souhaités : [PACKAGES_PARTAGES (ex: ui, utils, config-eslint, config-typescript, types)]
• Gestionnaire de paquets : [GESTIONNAIRE (pnpm, npm, yarn ou bun)]
• Technologies principales : [STACK_TECHNIQUE (ex: TypeScript, React, Tailwind CSS, Prisma)]

Génère une architecture complète de monorepo Turborepo incluant :

1. Structure des dossiers : arborescence complète avec apps/ et packages/, en expliquant le rôle de chaque dossier.

2. Fichiers de configuration racine :

   • turbo.json avec les pipelines (build, dev, lint, test, type-check) et les dépendances entre tâches
   • package.json racine avec les workspaces et scripts globaux
   • Configuration du gestionnaire de paquets (pnpm-workspace.yaml si pnpm)
   • tsconfig.json de base partagé

3. Packages partagés : pour chaque package listé, fournis :

   • Le package.json avec les exports corrects (main, types, exports map)
   • Le tsconfig.json qui étend la config de base
   • Un exemple de code source montrant le pattern d'export

4. Configuration des apps : comment chaque app référence les packages internes (avec le protocole workspace:*).

5. Pipeline Turborepo optimisé :

   • Ordre de build avec topological dependencies
   • Configuration du cache (inputs, outputs)
   • Variables d'environnement (globalEnv, env)

6. Scripts utilitaires :

   • Script pour créer un nouveau package
   • Script pour créer une nouvelle app
   • Commandes de développement courantes

7. CI/CD : exemple de GitHub Actions qui exploite le cache Turborepo et le Remote Caching.

8. Bonnes pratiques :

   • Gestion des dépendances (internes vs externes)
   • Stratégie de versioning
   • Convention de nommage des packages
   • Pièges courants à éviter

Fournis tous les fichiers avec leur contenu complet, prêts à être copiés. Ajoute des commentaires explicatifs dans le code.