Comment créer son premier dépôt GitHub ? Tutoriel débutant
Créer son premier dépôt GitHub consiste à ouvrir un compte gratuit, cliquer sur le bouton « New repository », nommer le dépôt et choisir sa visibilité, puis y ajouter des fichiers directement depuis l'interface web ou en local via Git, sans connaissance technique préalable.
Créer un dépôt GitHub prend moins de deux minutes : un compte gratuit, le bouton « New repository », un nom, une visibilité, puis l'ajout des premiers fichiers soit directement en ligne, soit via Git en local.
C'est quoi un dépôt GitHub concrètement ?
Un dépôt (« repository » en anglais) est le dossier de base sur GitHub : il contient les fichiers d'un projet et tout leur historique de modifications. Notre article c'est quoi GitHub présente la plateforme dans son ensemble ; celui-ci se concentre uniquement sur la création pratique de votre premier dépôt.
Le dossier versionné qui contient les fichiers du projet et leur historique.
Une « photo » des changements effectués, accompagnée d'un message descriptif. Notre article c'est quoi un dépôt Git détaille cette notion.
Public (visible par tous) ou privé (visible uniquement par les personnes invitées).
De quoi a-t-on besoin avant de commencer ?
- Un compte GitHub gratuit, créé avec une adresse email valide sur github.com/signup.
- Un navigateur web, suffisant pour créer un dépôt et y ajouter des fichiers sans rien installer.
- Git installé en local (facultatif), uniquement nécessaire pour la méthode avancée via ligne de commande détaillée plus bas.
Les étapes pour créer son premier dépôt
- 1. Créer un compte GitHubInscription gratuite avec une adresse email, un nom d'utilisateur et un mot de passe.
- 2. Cliquer sur « New repository »Depuis la page d'accueil GitHub, le bouton vert « New » ou le signe « + » en haut à droite.
- 3. Nommer le dépôtUn nom court, sans espace, qui décrit le projet (par exemple mon-premier-projet).
- 4. Choisir Public ou PrivéPublic si le code peut être vu par tous, Privé pour un projet personnel ou professionnel confidentiel.
- 5. Cocher « Add a README file »Cette case crée automatiquement un premier fichier de présentation, pratique pour démarrer.
- 6. Cliquer sur « Create repository »Le dépôt est créé immédiatement et prêt à recevoir des fichiers.
Comment envoyer ses premiers fichiers (commit) ?
Deux méthodes permettent d'ajouter des fichiers à un dépôt tout juste créé, selon le niveau de confort avec la ligne de commande.
Méthode web (sans Git)
- Ouvrir le dépôt, cliquer sur « Add file » puis « Upload files ».
- Glisser-déposer les fichiers depuis l'ordinateur.
- Écrire un court message de commit puis cliquer sur « Commit changes ».
Méthode Git en local
git clonel'adresse du dépôt pour le copier en local.- Ajouter ou modifier des fichiers, puis
git add .. git commit -m "premier commit"puisgit pushpour envoyer les changements.
Quelles bonnes pratiques adopter dès le départ ?
- Un README clair qui explique en quelques lignes ce que contient le dépôt et comment l'utiliser.
- Un fichier .gitignore adapté pour exclure les fichiers temporaires ou les dossiers de dépendances du suivi de version.
- Des commits fréquents et explicites, plutôt qu'un unique commit géant difficile à relire plus tard.
- Une branche principale protégée dès qu'un projet passe à plusieurs contributeurs, pour éviter d'écraser le travail d'un collègue par erreur.
Pour une agence qui gère plusieurs projets clients en parallèle, ces bonnes pratiques prennent une dimension supplémentaire : notre guide comment une agence doit versionner ses projets clients sur GitHub détaille l'organisation par dépôt, les accès par collaborateur et le transfert de propriété en fin de mission.
Quelles erreurs fréquentes éviter ?
Un fichier contenant un secret, même supprimé ensuite, reste visible dans l'historique du dépôt : mieux vaut le révoquer immédiatement s'il a été poussé par erreur, et toujours utiliser un fichier .env exclu du suivi.
Autre piège courant : créer un dépôt public par défaut pour un projet qui devait rester privé. La visibilité se change après coup dans les paramètres du dépôt, mais mieux vaut la vérifier dès l'étape de création.
Ce que nous observons chez les projets que nous accompagnons
Voici un exemple représentatif de notre pratique, sans donnée client ni chiffre inventé.
Un dépôt privé par défaut, sauf besoin explicite d'ouverture
Chez Amari Agency, nous créons systématiquement les dépôts des projets clients en visibilité privée, avec un README minimal mais un .gitignore complet dès la création pour éviter qu'un fichier de configuration sensible ne se retrouve versionné par erreur dans les premiers commits.
Quels contenus lire ensuite ?
Ces ressources complètent ce tutoriel sans cibler la même requête :
Questions fréquentes sur la création d'un dépôt GitHub
Faut-il savoir coder pour créer un dépôt GitHub ?
Non, la création d'un dépôt et l'ajout de fichiers via l'interface web ne demandent aucune connaissance en programmation. Seule la méthode Git en ligne de commande suppose quelques bases.
Un dépôt GitHub gratuit a-t-il des limites ?
Un compte gratuit permet de créer un nombre illimité de dépôts publics et privés, avec une limite de taille de 100 Mo par fichier et un espace de stockage global raisonnable pour un usage personnel.
Peut-on renommer un dépôt après sa création ?
Oui, dans les paramètres du dépôt (onglet Settings), à tout moment. GitHub redirige automatiquement l'ancienne adresse vers la nouvelle pendant un certain temps.
Quelle différence entre un dépôt public et privé ?
Un dépôt public est visible et clonable par n'importe qui sur internet, tandis qu'un dépôt privé n'est accessible qu'aux personnes explicitement invitées par le propriétaire.
Faut-il toujours cocher « Add a README file » ?
Ce n'est pas obligatoire, mais c'est recommandé : cela crée un premier commit automatiquement et évite d'avoir un dépôt totalement vide au départ.