Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

Créez des portfolios et sections web artistiques et animés avec GSAP pour ingénieurs logiciels. Idéal pour tout projet de portfolio, site perso, page d'accueil ou section animée, avec un rendu créatif et visuellement distinctif.

Qu'est-ce que TasmiaZerin1128.github.io ?

Cette compétence permet de générer des sites portfolio de développeur avec des animations GSAP de qualité cinématographique. Contrairement aux portfolios statiques ou aux effets gadgets, elle met l'accent sur une « dramaturgie intentionnelle » : chaque animation révèle ou souligne un contenu (nom, projets, compétences) pour raconter une histoire. Elle supporte les environnements HTML/JS (chargement via CDN) et React (via npm). Les motifs GSAP couverts incluent les révélations décalées, les animations de texte split, les sections épinglées avec scrub, les couches parallaxes, les effets magnétiques au survol et les défilements horizontaux. La compétence propose cinq directions esthétiques (Terminal Noir, Brutaliste, Soft Engineering, Néon Architecte, Analog Digital), une architecture de sections guidée (Hero, À propos, Compétences, Projets, Contact), des règles typographiques strictes avec des paires de polices Google Fonts ou Fontshare, et des palettes de couleurs via propriétés CSS. Les bonnes pratiques de performance (will-change, matchMedia), de responsive (clamp, pin sur mobile géré par gsap.matchMedia) et d'accessibilité (prefers-reduced-motion, HTML sémantique, contrastes) sont intégrées. Le livrable par défaut est un fichier HTML unique avec CSS et JS embarqués.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 === ' ' ? '&nbsp;' : 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: transform sur les éléments animés
  • Privilégiez transform et opacity plutô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

  1. Commencez par la direction esthétique — confirmez avec l'utilisateur ou choisissez en fonction de son style
  2. Construisez la structure HTML avec des sections sémantiques
  3. Stylisez avec CSS (propriétés personnalisées, typographie fluide, grille/flexbox)
  4. Ajoutez les animations GSAP section par section
  5. Ajoutez ScrollTrigger pour les révélations liées au défilement
  6. Ajoutez de l'interactivité (états de survol, effets de curseur, micro-interactions)
  7. Rendez le tout responsive
  8. Ajoutez la gestion de prefers-reduced-motion
  9. 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.

Skills associés