Comment Mettre en Ligne une Application React sur GitHub

Comment Mettre en Ligne une Application React sur GitHub

22 février 2026

Cet article explique comment j'utilise GitHub Pages pour mettre mes projets React en ligne gratuitement et les partager facilement sur Internet. Je détaille la configuration du fichier package.json, l'utilisation du paquet gh-pages et la marche à suivre pour héberger son code en quelques commandes. C'est l'étape finale idéale pour conclure mon parcours d'apprentissage, en passant du développement local à un site fonctionnel et accessible à tous.

Aujourd'hui, je vais vous expliquer comment mettre en ligne (déployer) votre application React sur GitHub. Pour montrer votre projet à tout le monde sur Internet. C'est très facile à suivre, même si vous êtes en débutant.

Il faut noter que ça fonctionne seulement pour des applications clientes, si vous avez un backend il est mieux de opter pour une autre solution.


Ce Dont Vous Avez Besoin

  • Un projet React : Vous pouvez créer un projet avec la commande npx create-react-app mon-app.
  • Un compte GitHub : Inscrivez-vous sur GitHub si ce n'est pas déjà fait.
  • Node.js installé sur votre ordinateur.

Étape 1 : Créer un Projet React

Si vous n'avez pas encore de projet, aller dans mon deuxième blogue ici

https://syslog.dti.crosemont.quebec/node/371

Étape 2 : Préparer Votre Projet pour GitHub

  1. Ouvrir le fichier package.json

    Dans ce fichier, ajoutez une nouvelle ligne appelée homepage. Elle doit ressembler à ça (remplacez votre-nom-utilisateur et mon-app par vos infos) :

    json
    1"homepage": "https://votre-nom-utilisateur.github.io/mon-app",
  2. Installer le paquet gh-pages

    Dans le terminal, tapez :

    sh
    1npm install --save gh-pages
  3. Modifier les scripts dans package.json

    Trouvez la partie "scripts" et ajoutez ces lignes :

    json
    1"predeploy": "npm run build",
    2"deploy": "gh-pages -d build"

    Ça doit ressembler à ça :

    json
    1    "scripts": {
    2    "start": "react-scripts start",
    3    "build": "react-scripts build",
    4    "test": "react-scripts test",
    5    "eject": "react-scripts eject",
    6    "predeploy": "npm run build",
    7    "deploy": "gh-pages -d build"
    8    },

Étape 3 : Créer un Dépôt sur GitHub

  1. Aller sur GitHub et créer un nouveau dépôt.
  • Cliquez sur le bouton "New" dans votre page d'accueil GitHub.
  • Donnez un nom à votre dépôt (par exemple, mon-app).
  1. Suivre les instructions qui vous sont données par GitHub pour connecter votre dépôt local au dépôt en ligne. En général, vous allez taper ces commandes dans votre terminal (remplacez l'URL par celle de votre dépôt) :
sh
1git init
2git add .
3git commit -m "Premier commit"
4git branch -M main
5git remote add origin https://github.com/votre-nom-utilisateur/mon-app.git
6git push -u origin main

Étape 4 : Déployer Votre Application

Maintenant que tout est prêt, tapez cette commande dans votre terminal :

npm run deploy

Cette commande va créer une version de votre application dans le dossier build et la mettre en ligne sur GitHub Pages.

Étape 5 : Voir Votre Application en Ligne

Ouvrez votre navigateur et allez à cette adresse :

https://votre-nom-utilisateur.github.io/mon-app

Vous devriez voir votre application React en ligne.

Petit détail

Il est possible que les applications React créée avec le CRA (create-react-app) ne fonctionnent pas au niveau du déploiement. Si c'est le cas je vous conseil d'utiliser vite.js pour initialiser votre projet React.

Conclusion

Voilà, vous êtes maintenant prêt à faire des applications React avancées à partir des concepts de composants jusqu'au déploiment de votre application. Maintenant c'est à vous d'exploiter les connaissances dont j'ai partagé dans mes blogs et de réaliser des projets innovants et amusants.

Bonne chance

Sources

Continuer la lecture

Plus d'articles