Compétence Portfolio GSAP
Créez des sites portfolio qui semblent sortir d'un studio créatif — mais avec l'âme d'un ingénieur logiciel. L'objectif n'est jamais « un portfolio corporate avec un hero et des cartes ». L'objectif est une expérience qui donne envie de s'arrêter de défiler.
Philosophie
Les portfolios de développeurs échouent de deux manières : ils sont ennuyeux (page blanche, grille de cartes, « Salut je suis développeur ») ou ils en font trop avec des effets déconnectés du contenu. Le juste milieu est une dramaturgie intentionnelle — chaque animation doit sembler révéler quelque chose, pas bouger pour le plaisir.
Considérez le portfolio comme un récit, pas une page. Le visiteur est guidé à travers une histoire : qui vous êtes → ce que vous avez construit → comment vous pensez → comment vous joindre.
Intégration GSAP
Chargez toujours GSAP depuis un CDN. Utilisez la version la plus récente depuis le CDN GSAP (pas cdnjs) :
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
Pour les projets React, installez via npm :
npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
Motifs GSAP essentiels à utiliser
1. Révélations décalées (Staggered Reveals) — Le pain quotidien. Ne révélez jamais un groupe d'éléments d'un coup.
gsap.from('.skill-item', {
y: 60,
opacity: 0,
duration: 0.8,
stagger: 0.12,
ease: 'power3.out',
scrollTrigger: {
trigger: '.skills-section',
start: 'top 80%',
}
});
2. Animations de texte fractionné (Text Split) — Divisez les titres en caractères/mots et animez-les. C'est l'animation au rendement le plus élevé que vous puissiez ajouter. Utilisez le plugin SplitText s'il est disponible, ou divisez manuellement avec des spans :
// Division manuelle par caractère
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
(char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? ' ' : char}</span>`
).join('');
gsap.from('.char', {
y: 120,
opacity: 0,
rotateX: -80,
stagger: 0.03,
duration: 1,
ease: 'power4.out',
});
3. Épinglage lié au défilement (Scroll-Driven Pinning) — Épinglez des sections et animez leur contenu au fil du défilement. Crée cet effet « cinématographique ».
gsap.timeline({
scrollTrigger: {
trigger: '.pinned-section',
start: 'top top',
end: '+=200%',
pin: true,
scrub: 1,
}
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');
4. Couches parallaxes — Donnez de la profondeur avec différentes vitesses de défilement.
gsap.to('.bg-layer', {
yPercent: -30,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true,
}
});
5. Effets magnétiques / Suivi du curseur — Pour les éléments interactifs comme les CTA ou les projets mis en avant.
const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
const rect = btn.getBoundingClientRect();
const x = e.clientX - rect.left - rect.width / 2;
const y = e.clientY - rect.top - rect.height / 2;
gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});
6. Sections à défilement horizontal — Parfaites pour les présentations de projets. On défile verticalement mais le contenu se déplace horizontalement.
const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');
gsap.to(items, {
xPercent: -100 * (items.length - 1),
ease: 'none',
scrollTrigger: {
trigger: track,
pin: true,
scrub: 1,
end: () => '+=' + track.scrollWidth,
}
});
Consultez references/gsap-patterns.md pour des motifs plus avancés, notamment les formes morphing, les traînées de curseur personnalisées, les mouvements basés sur le bruit et des pistes d'intégration WebGL.
Direction esthétique
Pour le portfolio d'un ingénieur logiciel, ces directions esthétiques fonctionnent le mieux. Choisissez-en une par projet — ne les mélangez jamais :
1. Terminal Noir
Fond sombre, typographie monospace mélangée à un sans-serif acéré, accents vert/ambre/cyan sur fond noir. Donne l'impression d'être à l'intérieur d'un terminal — mais en beau. Utilisez des superpositions de lignes de balayage, des curseurs clignotants, des animations de frappe. Pensez : esthétique hacker rencontre design éditorial.
2. Code Brutaliste
Structure brute et exposée. Lignes de grille visibles, typographie mono de grande taille, contraste marqué. Les éléments semblent placés avec position: absolute intentionnellement. Les animations sont vives et mécaniques — pas d'ease-out, utilisez steps() ou power4.inOut. Pensez : si un compilateur avait du goût.
3. Ingénierie Douce (Soft Engineering)
Fonds clairs avec des tons neutres chauds, grands espaces blancs, serif élégant pour les titres associé à un sans-serif propre. Animations fluides et élégantes. Donne une sensation premium et calme. Pensez : si Dieter Rams concevait un portfolio.
4. Architecte Néon (Neon Architect)
Base sombre, accents néon vifs (magenta, bleu électrique, lime), glassmorphisme, effets de lueur. Animations fluides, presque liquides. Mise en page basée sur une grille avec des éléments qui se chevauchent. Pensez : Blade Runner rencontre le design suisse.
5. Analogique Digital (Analog Digital)
Textures papier, éléments dessinés à la main mélangés à une typographie numérique nette, subtiles superpositions de grain. Palette de couleurs chaudes. Les animations imitent un mouvement physique — les choses glissent comme du papier, s'empilent comme des cartes. Pensez : un développeur qui croque aussi.
Architecture des sections
Un portfolio solide suit cette structure. Chaque section doit donner l'impression d'être sa propre « scène » :
Hero
Les 3 premières secondes comptent le plus. Commencez par une animation de texte — le visiteur doit voir votre nom prendre vie. Incluez une animation d'ambiance subtile en arrière-plan (particules flottantes, formes morphing, animation de dégradé). Gardez le message simple : Nom + identité en une ligne.
À propos / Philosophie
Ne vous contentez pas d'énumérer des faits. Exprimez une vision du monde. Utilisez une révélation déclenchée par le défilement pour dévoiler le texte ligne par ligne. Une photo est optionnelle mais si incluse, utilisez un traitement créatif (duotone, révélations par clip-path, parallaxe décalée).
Compétences / Stack technique
N'utilisez JAMAIS une grille de logos ennuyeuse. Essayez plutôt : une visualisation orbitale, un ticker/marquee défilant, des étiquettes interactives qui réagissent au survol, une carte de constellation, ou une liste de style terminal qui se « tape » toute seule.
Projets
La pièce maîtresse. Chaque projet a besoin d'espace pour respirer. Utilisez soit : une galerie à défilement horizontal, des cartes en plein écran empilées qui s'épingle et se transforment, ou des cartes extensibles avec révélations déclenchées par le défilement. Chaque projet doit montrer : titre, brève description, technologies utilisées et un visuel (capture d'écran, vidéo ou illustration créative).
Contact / Pied de page
Terminez avec intention. Un grand CTA typographique, peut-être un message basé sur l'heure (« Bonsoir — parlons-en »), et des liens de contact clairs. Restez percutant.
Consultez references/portfolio-sections.md pour des modèles HTML/CSS/JS détaillés pour chaque type de section.
Règles typographiques
Importez les polices depuis Google Fonts. N'utilisez jamais les polices système, Inter ou Roboto.
Bonnes associations pour les portfolios de développeurs :
- Affichage + Corps : « Clash Display » + « Satoshi » (via le CDN fontshare.com)
- Affichage + Corps : « Syne » + « Work Sans » (Google Fonts)
- Affichage + Corps : « Space Grotesk » + « DM Sans » (Google Fonts) — seulement pour un style technologique
- Mono + Sans : « JetBrains Mono » + « General Sans » (fontshare) — pour l'esthétique terminal
- Serif + Sans : « Playfair Display » + « Source Sans 3 » — pour l'orientation douce/premium
- Affichage + Corps : « Anybody » + « Instrument Sans » (Google Fonts)
- Affichage + Corps : « Bricolage Grotesque » + « Geist » (via CDN)
Chargez via :
<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">
ou
<link href="https://fonts.googleapis.com/css2?family=Syne:wght@400;500;600;700;800&family=Work+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">
Règles de couleur
Définissez une palette à l'aide de propriétés personnalisées CSS. Chaque palette a besoin de :
--bg: fond principal--fg: texte principal--accent: couleur d'accent principale--accent-2: second accent (optionnel)--muted: texte / bordures atténués--surface: fond des cartes/sections
Exemple (Terminal Noir) :
:root {
--bg: #0a0a0a;
--fg: #e8e8e8;
--accent: #00ff88;
--accent-2: #0088ff;
--muted: #333;
--surface: #111;
}
Exemple (Ingénierie Douce) :
:root {
--bg: #f8f5f0;
--fg: #1a1a1a;
--accent: #c45d3e;
--accent-2: #2d5a7b;
--muted: #b8b0a4;
--surface: #ffffff;
}
Règles de performance
GSAP est performant par défaut, mais suivez ces règles :
- Utilisez
will-change: transformsur les éléments animés - Privilégiez
transformetopacityplutôt que les propriétés de mise en page (width, height, top, left) - Utilisez
ScrollTrigger.batch()pour de nombreux éléments similaires au lieu de déclencheurs individuels - Ajoutez
loading="lazy"aux images situées sous la ligne de flottaison - Gardez le poids total de la page sous 2 Mo (hors vidéos)
- Utilisez
gsap.matchMedia()pour désactiver les animations lourdes sur mobile :
gsap.matchMedia().add('(max-width: 768px)', () => {
// Animations mobiles plus simples ici
});
Responsive
Chaque section doit fonctionner sur mobile. Règles clés :
- Tailles de police : utilisez
clamp()pour une mise à l'échelle fluide — ex.clamp(2rem, 5vw, 5rem) - Les sections à défilement horizontal doivent se transformer en empilement vertical sur mobile
- Sections épinglées : réduisez la durée d'épinglage ou supprimez-le sur mobile via
gsap.matchMedia() - Cibles tactiles : boutons/liens d'au moins 44 px
- Testez aux points de rupture 375 px, 768 px, 1440 px
Accessibilité
Les portfolios animés doivent rester accessibles :
- Respectez
prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
gsap.globalTimeline.timeScale(0); // ou ignorez complètement les animations
}
- HTML sémantique : utilisez
<main>,<section>,<nav>,<header>,<footer> - Texte alternatif (alt) sur toutes les images
- Éléments interactifs navigables au clavier
- Contraste de couleur suffisant (4,5:1 minimum pour le texte courant)
Lors de la construction
- Commencez par la direction esthétique — confirmez avec l'utilisateur ou choisissez en fonction de son style
- Construisez la structure HTML avec des sections sémantiques
- Stylisez avec CSS (propriétés personnalisées, typographie fluide, grille/flexbox)
- Ajoutez les animations GSAP section par section
- Ajoutez ScrollTrigger pour les révélations liées au défilement
- Ajoutez de l'interactivité (états de survol, effets de curseur, micro-interactions)
- Rendez le tout responsive
- Ajoutez la gestion de
prefers-reduced-motion - Optimisez (chargement paresseux, will-change, matchMedia pour mobile)
Générez toujours un seul fichier HTML avec CSS et JS intégrés, sauf si l'utilisateur spécifie un framework.