N-HiTec Logo

Création d'un projet sur Git et GitHub

Suivez ce guide étape par étape pour créer et publier votre premier projet sur GitHub ! 🚀

Guide complet en 7 étapes

1

Créer le répertoire du projet

bash
mkdir nom-du-projet
cd nom-du-projet

Crée un nouveau dossier pour votre projet et naviguez dedans.

2

Initialiser le dépôt Git

bash
git init

Initialise un nouveau dépôt Git dans le dossier du projet. Un dossier caché .git est créé.

3

Créer un fichier README

bash
touch README.md

Crée un fichier README pour documenter votre projet. C'est la première chose que les visiteurs verront !

4

Premier commit

bash
git add .
git commit -m "Initial commit"

Ajoute tous les fichiers au staging et crée votre premier commit.

5

Créer le dépôt sur GitHub

bash
gh repo create nom-du-projet --public

Crée un nouveau dépôt GitHub via la CLI (ou via l'interface web).

💡 Alternative : Vous pouvez aussi créer le dépôt via l'interface web sur github.com/new

6

Lier le dépôt local à GitHub

bash
git remote add origin git@github.com:votre-utilisateur/nom-du-projet.git

Associe votre dépôt local au dépôt distant sur GitHub.

7

Pousser le commit initial

bash
git push -u origin main

Envoie votre premier commit sur GitHub. L'option -u définit la branche par défaut.

Récapitulatif du workflow complet

📁 Local

  • ✓ Créer le dossier
  • ✓ Initialiser Git
  • ✓ Créer README.md
  • ✓ Premier commit

☁️ GitHub

  • ✓ Créer le dépôt distant
  • ✓ Lier local ↔ distant

🚀 Publication

  • ✓ Push vers GitHub
  • ✓ Projet en ligne !

🎓 Bonnes pratiques

  • •Utilisez des noms de projet clairs et descriptifs (en minuscules, avec des tirets)
  • •Rédigez un README.md complet avec description, installation et utilisation
  • •Ajoutez un .gitignore pour exclure les fichiers inutiles (node_modules, .env, etc.)
  • •Choisissez une licence appropriée pour votre projet (MIT, GPL, Apache, etc.)