Ce guide vous accompagne dans l'installation et la configuration d'un environnement Next.js sur un PC vierge.

Avant de commencer, assurez-vous d'installer les éléments suivants :

• Visual Studio Code (VSC)
• Node.js (Vérification : node -v en ligne de commande)
• Git (si Windows) (Vérification : git -v en ligne de commande)

👉 Pendant l'installation, utilisez les options par défaut si vous débutez.

Si ce n'est pas encore fait, inscrivez-vous sur GitHub.

Ouvrez un terminal (Git Bash ou PowerShell) et entrez ces commandes :

git config --global user.name "TonNom"
git config --global user.email "TonEmail@exemple.com"

Vérifiez la configuration avec :

git config --global --list

Vous devriez voir :

user.name=TonNom
user.email=TonEmail@exemple.com

Exécutez la commande suivante :

ssh-keygen -t ed25519 -C "TonEmail@exemple.com"

Appuyez sur Entrée pour enregistrer la clé dans le dossier par défaut (~/.ssh/id_ed25519). Vous pouvez ajouter une passphrase (optionnel).

Affichez la clé publique avec :

cat ~/.ssh/id_ed25519.pub

Copiez la clé générée (elle commence par ssh-ed25519).

1. Connectez-vous sur GitHub.
2. Allez dans Settings → SSH and GPG keys → New SSH Key.
3. Collez votre clé publique et donnez-lui un nom (ex. "Mon PC").

ssh -T git@github.com

Si tout est bien configuré, vous verrez un message du type :

Hi <ton-nom-utilisateur>! You've successfully authenticated...

Pour récupérer un projet existant depuis GitHub :

1. Copiez l'URL HTTPS du dépôt GitHub :
   • Sur la page du dépôt, cliquez sur Code → HTTPS.
2. Ouvrez Visual Studio Code.
3. Appuyez sur Ctrl + Maj + P, puis tapez git clone.
4. Collez l'URL du dépôt :

git clone https://github.com/koala819/StarterPack.git

Cela téléchargera le projet dans un dossier local. 🎉 Vous avez maintenant le projet Starter Pack entre vos mains ! 🚀

Lorsque tu clones un dépôt, il reste lié au dépôt original comme "remote". Tu dois supprimer ce lien avant de publier ton propre dépôt.

1. Va dans le répertoire cloné :

   cd exemple

2. Vérifie les "remotes" configurés :

   git remote -v

   Tu devrais voir quelque chose comme ceci :

   origin  https://github.com/utilisateur/exemple.git (fetch)
   origin  https://github.com/utilisateur/exemple.git (push)
   

3. Supprime le lien avec le dépôt distant :

   git remote remove origin

4. Vérifie que le lien a bien été supprimé :

   git remote -v

   Cela ne devrait rien afficher.

1. Connecte-toi à ton compte GitHub.
2. Clique sur le bouton New Repository ou va sur Créer un nouveau dépôt.
3. Remplis les informations pour créer un dépôt (nom, description, etc.) et clique sur Create repository.
4. Ne coche pas les cases pour initialiser le dépôt avec un README, un .gitignore, ou une licence.

1. Récupère l'URL de ton nouveau dépôt GitHub (elle sera affichée après sa création).

2. Lien ton dépôt local à ce nouveau dépôt :

   git remote add origin <URL_DE_TON_DEPOT>

   Exemple :

   git remote add origin https://github.com/ton-utilisateur/ton-depot.git

3. Vérifie que le dépôt distant est bien configuré :

   git remote -v

   Tu devrais voir :

   origin  https://github.com/ton-utilisateur/ton-depot.git (fetch)
   origin  https://github.com/ton-utilisateur/ton-depot.git (push)
   

1. Ajoute tous les fichiers (si ce n’est pas encore fait) :

   git add .

2. Fais un commit :

   git commit -m "Initial commit"

3. Pousse les fichiers vers ton dépôt GitHub :

   git push -u origin main

   Remarque : Si ta branche principale s’appelle master au lieu de main, remplace main par master.

Va sur ton dépôt GitHub pour vérifier que tous les fichiers sont bien publiés. Si tout est bon, ton dépôt est maintenant hébergé sur ton propre compte GitHub.

Si tu souhaites apporter des modifications au code, tu peux les faire dans le répertoire local avant d'exécuter les commandes git add et git push.

Si tu récupères un projet open-source, vérifie bien les termes de la licence (s’il y en a une). Certaines licences imposent des règles spécifiques pour réutiliser ou republier le code. Si le dépôt n’a pas de licence, demande l’autorisation de l’auteur avant de republier. 😊