Un recruteur passe en moyenne quelques minutes sur un portfolio de développeur avant de décider s’il te contacte. Ce qu’il cherche n’est pas un design spectaculaire, mais des preuves : des projets qui fonctionnent, un code lisible et une capacité à expliquer tes choix. Voici comment construire un portfolio qui donne vraiment envie de t’embaucher.
Un portfolio de développeur est souvent le premier contact entre toi et un recruteur, un client ou une école. Pour un junior ou une personne en reconversion, c’est même la pièce la plus importante de la candidature : faute d’expérience professionnelle, ce sont tes projets qui prouvent ce que tu sais faire. Un bon portfolio peut compenser l’absence de diplôme en informatique ; un portfolio vide ou bâclé peut faire écarter un excellent profil.
Pourtant, beaucoup de portfolios ratent leur cible. Trop de projets de tutoriels, pas de démo en ligne, des dépôts GitHub sans explication, un site magnifique mais lent, ou au contraire une simple liste de liens. Ce guide te montre ce que les recruteurs regardent vraiment, quels projets mettre en avant, et comment présenter chacun d’eux pour qu’il fasse la différence.
Un bon portfolio de développeur, c’est 3 à 5 projets personnels soignés plutôt que vingt exercices, chacun avec une démo en ligne, un code propre sur GitHub avec un vrai README, et une explication du problème résolu et de tes choix techniques.
Ce que les recruteurs regardent vraiment
Un recruteur technique ne lit pas ton portfolio de développeur comme un visiteur ordinaire. Il cherche rapidement des réponses à quelques questions précises :
- Sais-tu terminer un projet ? Une application complète, même simple, vaut plus que dix projets à moitié commencés.
- Ton code est-il lisible ? Des noms clairs, une structure logique, des commits réguliers et explicites.
- Comprends-tu ce que tu as fait ? Ton explication des choix techniques montre si tu as conçu le projet ou si tu l’as recopié.
- Es-tu autonome ? Un projet personnel original prouve que tu sais chercher, décider et résoudre des problèmes.
- Peux-tu travailler en équipe ? Des contributions à d’autres projets, des merge requests, un historique Git propre.
| Ce qui impressionne peu | Ce qui impressionne vraiment |
|---|---|
| — | — |
| 20 projets de tutoriels (calculatrice, to-do list, météo) | 3 projets personnels qui résolvent un vrai problème |
| Une liste de 15 technologies maîtrisées | Les technologies démontrées dans des projets concrets |
| Un site avec des animations partout | Un site rapide, lisible et accessible |
| Des liens GitHub sans README | Un README qui explique, montre et guide l’installation |
| « Projet en cours » depuis un an | Un projet terminé, en ligne, avec une démo |
Retiens cette idée : ton portfolio de développeur n’est pas une vitrine de tout ce que tu as touché, c’est une sélection de ce que tu fais de mieux.
Les 3 à 5 projets à mettre dans ton portfolio de développeur
La qualité l’emporte toujours sur la quantité. Trois projets bien choisis et bien présentés suffisent pour un premier emploi. L’idéal est de couvrir des compétences complémentaires plutôt que de montrer trois fois la même chose.
| Type de projet | Ce qu’il prouve | Exemples |
|---|---|---|
| — | — | — |
| Une application complète (front + back + base de données) | Tu sais construire un produit de bout en bout | Gestion de stock, réservation, planning, petit e-commerce |
| Un projet qui résout un vrai problème | Tu sais partir d’un besoin réel | Un outil pour une association, l’automatisation d’une tâche de ton ancien métier |
| Un projet technique ciblé | Tu maîtrises un sujet précis | Une API documentée, un bot, une application mobile publiée |
| Une contribution ou un travail d’équipe | Tu sais collaborer | Une contribution open source, un projet de groupe avec un historique Git propre |
Le projet « qui résout un vrai problème » est souvent le plus convaincant, surtout en reconversion. Si tu viens de la comptabilité, de la logistique ou de la santé, un outil qui répond à un problème de ton ancien métier montre à la fois tes compétences techniques et ta compréhension d’un domaine. C’est un argument que les autres candidats n’ont pas.
Ils ne sont pas interdits, à condition de les avoir transformés : nouvelles fonctionnalités, autre design, autre technologie. Un projet construit à partir de notre tutoriel de gestion de stock en PHP/MySQL, enrichi d’un script d’installation, de nouvelles fonctionnalités et d’un déploiement réel, devient un vrai projet personnel. Mentionne simplement la base de départ, c’est une preuve d’honnêteté.
Présenter chaque projet comme une étude de cas
La présentation d’un projet compte autant que le projet lui-même. Pour chacun, prévois une page ou une section structurée comme une petite étude de cas. C’est ce qui transforme un simple lien en argument de recrutement.
1. Le problème. En deux phrases : quel besoin le projet résout, et pour qui.
2. La solution. Ce que fait l’application, avec deux ou trois captures d’écran ou une courte vidéo.
3. Les technologies. La liste, et surtout pourquoi tu les as choisies.
4. Les difficultés. Un ou deux problèmes techniques rencontrés, et comment tu les as résolus.
5. Les liens. La démo en ligne et le dépôt GitHub.
6. La suite. Ce que tu améliorerais avec plus de temps.
La partie « difficultés » est la plus précieuse pour un recruteur. Elle montre ta façon de raisonner, et elle te prépare à l’entretien : on te posera presque toujours la question « quel a été le problème le plus difficile de ce projet ? ».
Un README qui fait la différence
Beaucoup de recruteurs ouvrent directement GitHub. Un dépôt sans README, ou avec le README par défaut, donne l’impression d’un projet abandonné. Un bon README, au contraire, met en valeur ton portfolio de développeur même pour quelqu’un qui ne lancera jamais ton code.
# Planning Pro : gestion de plannings pour petites équipes
Application web pour créer et partager les plannings d'une équipe de 5 à 50 personnes.
**Démo en ligne :** https://planning-demo.exemple.fr (compte de test : demo / demo2026)
## Fonctionnalités
- Création de plannings par glisser-déposer
- Gestion des congés et des absences
- Export PDF et notifications par e-mail
## Technologies
PHP 8.4, MySQL 8.4, JavaScript, Docker
## Installation
git clone https://github.com/ton-compte/planning-pro.git
cd planning-pro
cp .env.example .env
docker compose up -d
## Ce que j'ai appris
La gestion des fuseaux horaires et des conflits d'horaires...Remarque l’installation en quatre commandes grâce à Docker et au fichier .env.example : un recruteur technique peut lancer ton projet en deux minutes. Si tu ne maîtrises pas encore ces outils, nos guides sur le fichier .env et l’antisèche des commandes Docker te montrent comment faire.
Laisser des mots de passe, des clés d’API ou des fichiers .env dans les dépôts publics de ton portfolio de développeur. C’est la première chose qu’un recruteur attentif remarquera, et c’est un signal très négatif sur ta rigueur en matière de sécurité.
GitHub : ta deuxième vitrine
Ton profil GitHub fait partie intégrante de ton portfolio de développeur. Quelques réglages simples changent l’impression qu’il donne.
- Épingle tes meilleurs projets : GitHub permet d’afficher six dépôts en haut de ton profil. Choisis ceux de ton portfolio.
- Crée un README de profil : un dépôt portant ton nom d’utilisateur affiche son README sur ta page d’accueil. Présente-toi en quelques lignes.
- Soigne tes messages de commit : « fix » répété trente fois donne une mauvaise image ; « Corrige le calcul du total quand le panier est vide » montre ta rigueur.
- Range ou archive les vieux exercices : rends-les privés ou archive-les pour qu’ils ne masquent pas tes vrais projets.
Si tu débutes avec Git, notre guide Git et GitHub pour débutant t’aide à configurer ton poste proprement, et l’antisèche Git te donne les commandes pour garder un historique clair.
Le site du portfolio de développeur : simple et rapide
Faut-il un site dédié ? Ce n’est pas obligatoire : un profil GitHub soigné et un document de présentation peuvent suffire. Mais un site personnel est un excellent projet en lui-même, et il te permet de contrôler entièrement la présentation.
Les règles d’un bon site de portfolio de développeur :
- Rapide : un recruteur n’attendra pas cinq secondes qu’une animation se charge. Vise un site léger, optimisé, qui s’affiche instantanément.
- Lisible sur mobile : beaucoup de premiers coups d’œil se font sur téléphone.
- Structuré en quatre sections : une présentation courte, les projets, les compétences, un moyen de contact.
- Hébergé gratuitement ou presque : GitHub Pages, GitLab Pages ou un petit hébergement suffisent largement.
- Accessible : contrastes suffisants, textes alternatifs sur les images, navigation au clavier. C’est aussi une compétence que tu démontres.
<!-- Structure minimale d'une carte de projet -->
<article class="projet">
<img src="planning-pro.webp" alt="Tableau de bord de l'application Planning Pro" loading="lazy">
<h3>Planning Pro</h3>
<p>Gestion de plannings pour petites équipes. PHP 8.4, MySQL, Docker.</p>
<a href="https://planning-demo.exemple.fr">Voir la démo</a>
<a href="https://github.com/ton-compte/planning-pro">Voir le code</a>
</article>Pour la mise en forme, notre tutoriel carte de profil en HTML et CSS est une excellente base pour la section de présentation.
Mettre les projets en ligne
Une démo en ligne multiplie l’impact d’un projet : un recruteur clique, teste, et voit immédiatement ce que tu as construit. Sans démo, il doit te croire sur parole ou installer le projet, ce qu’il fera rarement.
| Type de projet | Où le mettre en ligne |
|---|---|
| — | — |
| Site statique (HTML, CSS, JavaScript) | GitHub Pages, GitLab Pages |
| Application PHP et MySQL | Un hébergement mutualisé, ou un petit serveur |
| Application Node.js ou Python | Une plateforme d’hébergement d’applications ou un petit serveur |
| Application mobile Android | Le Google Play Store |
Publier une application sur un store est un atout fort dans un portfolio de développeur : cela montre que tu sais aller jusqu’au bout, y compris les étapes administratives. Notre guide publier son application sur le Google Play Store détaille toute la démarche.
Prévois un compte de démonstration avec des données fictives, pour qu’un visiteur puisse tester sans créer de compte. Et surveille tes démos : une démo en panne fait plus de tort qu’une absence de démo.
Les erreurs qui ruinent un portfolio de développeur
- Trop de projets de tutoriels identiques à l’original : le recruteur reconnaît immédiatement l’application météo ou la to-do list de base.
- Des liens cassés ou des démos hors ligne : vérifie tous tes liens avant chaque candidature.
- Des fautes d’orthographe : elles donnent une impression de négligence, alors qu’un correcteur les élimine en quelques minutes.
- Une liste interminable de technologies : « HTML, CSS, JavaScript, React, Vue, Angular, PHP, Java, Python, C++… » sans projet pour le prouver éveille surtout la méfiance.
- Aucun moyen de contact clair : une adresse e-mail professionnelle et un profil LinkedIn à jour, bien visibles.
- Un portfolio jamais mis à jour : ajoute chaque nouveau projet terminé, et retire les plus faibles.
Fais relire ton portfolio de développeur par une personne qui ne code pas. Si elle ne comprend pas, en trente secondes, ce que fait chaque projet, ta présentation est trop technique ou pas assez claire. Un recruteur non technique filtre souvent les candidatures avant l’entretien technique.
Faire connaître ton portfolio de développeur
Un excellent portfolio de développeur ne sert à rien si personne ne le voit. Une fois tes projets en ligne, pense à les rendre visibles là où se trouvent les recruteurs.
- LinkedIn : ajoute le lien de ton portfolio dans ton profil, et publie un court message pour chaque nouveau projet terminé, avec une capture d’écran et ce que tu as appris. Ces publications attirent souvent plus d’attention qu’une candidature classique.
- Ton CV : un lien court et lisible vers ton portfolio, en haut de la page, à côté de ton e-mail. Ajoute aussi un lien direct vers ton meilleur projet.
- Les communautés de développeurs : forums, serveurs Discord, meetups locaux. Présenter un projet et demander des retours est une excellente façon de progresser et de te faire connaître.
- Tes candidatures : dans chaque lettre ou message, cite le projet de ton portfolio de développeur le plus proche du poste visé, et explique en une phrase pourquoi il est pertinent.
Cette dernière astuce est très efficace : adapter la mise en avant de tes projets à chaque offre montre que tu as lu l’annonce et que tu sais relier tes compétences aux besoins de l’entreprise. Un recruteur qui cherche un développeur PHP sera bien plus réceptif à un lien direct vers ton application PHP qu’à une invitation générale à « découvrir ton portfolio ».
Préparer l’entretien grâce à ton portfolio de développeur
Ton portfolio de développeur ne sert pas seulement à décrocher l’entretien : il en devient souvent le fil conducteur. Beaucoup d’entretiens techniques commencent par « présente-moi un de tes projets ». Prépare pour chacun une présentation de deux minutes, et sois prêt à répondre à ces questions :
- Pourquoi as-tu choisi cette technologie plutôt qu’une autre ?
- Quel a été le problème le plus difficile, et comment l’as-tu résolu ?
- Comment as-tu sécurisé l’authentification et les formulaires ?
- Que changerais-tu si tu recommençais aujourd’hui ?
- Comment ferais-tu évoluer le projet pour dix fois plus d’utilisateurs ?
La question sur la sécurité revient très souvent. Pouvoir expliquer que tu as utilisé des requêtes préparées, password_hash() et des jetons CSRF fait une excellente impression. Nos guides pour sécuriser un formulaire PHP et stocker les mots de passe te donnent les arguments.
FAQ
Combien de projets faut-il dans un portfolio de développeur ?
Trois à cinq projets bien choisis suffisent, surtout pour un premier emploi. Mieux vaut trois projets terminés, en ligne et bien documentés qu’une quinzaine d’exercices inachevés ou issus de tutoriels.
Faut-il obligatoirement un site web pour son portfolio ?
Non. Un profil GitHub soigné, avec des dépôts épinglés et de bons README, peut suffire. Un site personnel reste un plus, car il permet de présenter chaque projet comme une étude de cas et constitue lui-même une démonstration de compétences.
Peut-on mettre des projets réalisés en formation ?
Oui, s’ils sont de bonne qualité et que tu les présentes honnêtement. L’idéal est de les avoir enrichis après la formation, pour montrer ta capacité à aller plus loin seul.
Mon code n’est pas parfait, dois-je attendre avant de publier ?
Non. Aucun code n’est parfait, et un recruteur le sait. Publie des projets propres et fonctionnels, documente leurs limites dans le README, et montre ta progression en les améliorant au fil du temps.
Portfolio de développeur : le résumé à retenir
- Un portfolio de développeur est une sélection de 3 à 5 projets, pas une liste exhaustive.
- Privilégie des projets personnels qui résolvent un vrai problème, complétés par un projet complet et un projet technique ciblé.
- Présente chaque projet comme une étude de cas : problème, solution, technologies, difficultés, liens.
- Soigne GitHub : projets épinglés, README détaillés, commits clairs, aucun secret publié.
- Mets tes projets en ligne avec un compte de démonstration, et vérifie régulièrement les liens.
Un portfolio de développeur se construit dans la durée. Commence avec un projet aujourd’hui, puis enrichis-le à chaque nouveau projet terminé.
Conclusion
Ton portfolio de développeur est la preuve concrète de ce que tu sais faire. Il ne demande ni diplôme ni expérience professionnelle : seulement des projets terminés, bien présentés, et une capacité à expliquer tes choix. Si tu as encore du mal à te lancer dans des projets personnels, notre guide pour sortir du tutorial hell t’aidera à passer de spectateur à constructeur, et nos tutoriels comme le ChatGPT local avec Ollama te donneront des idées de projets originaux à personnaliser.
Sources
- Documentation GitHub : personnaliser son profil
- Documentation GitHub Pages
- MDN : les bases de l’accessibilité web
- Stack Overflow Developer Survey
