Cloner un projet Next.js

Prérequis

Avant de commencer, assurez-vous d'avoir installé :

• Git
• Node.js 18.x ou supérieur
• npm, yarn, pnpm ou bun

1. Cloner le projet

Clonez le repository GitHub sur votre machine locale :

git clone https://github.com/username/project-name.git
cd project-name

2. Installer les dépendances

Installez toutes les dépendances du projet :

npm install

Ou avec yarn :

yarn install

Ou avec pnpm :

pnpm install

3. Configuration de l'environnement

Créez le fichier .env.local à partir du fichier .env.example :

cp .env.example .env.local

Modifiez le fichier .env.local pour configurer :

• Variables d'API : clés d'API tierces
• URLs : NEXT_PUBLIC_API_URL, etc.
• Base de données : si applicable

Exemple :

NEXT_PUBLIC_API_URL=http://localhost:3000/api
DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
NEXTAUTH_SECRET=your_secret_key
NEXTAUTH_URL=http://localhost:3000

4. Configuration de la base de données (si nécessaire)

Si le projet utilise Prisma :

npx prisma generate
npx prisma db push

Ou pour exécuter les migrations :

npx prisma migrate dev

Pour charger des données de test :

npx prisma db seed

5. Lancer le serveur de développement

Démarrez le serveur de développement :

npm run dev

Ou avec yarn :

yarn dev

Ou avec pnpm :

pnpm dev

Le projet sera accessible sur : http://localhost:3000

6. Build pour la production

Pour créer un build de production :

npm run build
npm run start

Problèmes courants

Erreur de versions de Node.js

Vérifiez la version requise dans le fichier package.json ou .nvmrc. Utilisez nvm pour changer de version :

nvm install
nvm use

Erreur de cache

Supprimez les fichiers de cache et réinstallez :

rm -rf node_modules .next
npm install

Conflits de dépendances

Essayez de supprimer le lock file et réinstaller :

rm package-lock.json
npm install

Ou forcez l'installation :

npm install --force

Variables d'environnement non reconnues

Les variables publiques dans Next.js doivent commencer par NEXT_PUBLIC_ pour être accessibles côté client.

Port déjà utilisé

Changez le port par défaut :

npm run dev -- -p 3001

Commandes utiles

• Analyser le bundle : npm run build && npm run analyze
• Linter le code : npm run lint
• Formater le code : npm run format
• Tester : npm run test
• Type checking : npm run type-check

Configuration avec Docker (optionnel)

Si le projet contient un Dockerfile :

docker build -t nextjs-app .
docker run -p 3000:3000 nextjs-app

Avec Docker Compose :

docker-compose up