Was macht GSAP-Portfolio-Skill?
Baue Portfolio-Websites, die sich anfühlen, als kämen sie von einem kreativen Studio – aber mit der Seele eines Softwareentwicklers. Das Ziel ist niemals ein langweiliges 'Corporate-Dev-Portfolio mit Held und Karten'. Das Ziel ist ein Erlebnis, das jemanden zum Stoppen des Scrollens bringt.
Philosophie
Entwickler-Portfolios scheitern auf zwei Arten: Sie sind entweder langweilig (weiße Seite, Kartenraster, 'Hi, ich bin ein Entwickler') oder sie bemühen sich zu sehr mit Effekten, die sich vom Inhalt losgelöst anfühlen. Der Sweet Spot ist zielgerichtetes Drama – jede Animation sollte sich anfühlen, als würde sie etwas enthüllen, nicht nur um der Bewegung willen da sein.
Betrachte das Portfolio als eine Erzählung, nicht als eine Seite. Der Besucher wird durch eine Geschichte geführt: Wer du bist → Was du gebaut hast → Wie du denkst → Wie man dich erreicht.
GSAP-Integration
Lade GSAP immer vom CDN. Verwende die neueste Version vom GSAP-CDN (nicht 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>
Für React-Projekte per npm installieren:
npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
Wichtige GSAP-Muster
1. Gestaffelte Einblendungen – Die Grundlage. Zeige eine Gruppe von Elementen niemals alle auf einmal an.
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. Text-Split-Animationen – Teile Überschriften in Zeichen/Wörter auf und animiere sie ein. Dies ist die wichtigste Animation. Verwende das SplitText-Plugin, falls verfügbar, oder teile manuell mit Spans:
// Manuelle Zeichenaufteilung
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. Scrollgesteuertes Pinning – Fixiere Abschnitte und animiere den Inhalt darin, während der Benutzer scrollt. Erzeugt dieses 'filmische' Gefühl.
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. Parallax-Ebenen – Gib Tiefe mit unterschiedlichen Scrollgeschwindigkeiten.
gsap.to('.bg-layer', {
yPercent: -30,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true,
}
});
5. Magnetische / Cursor-Follow-Effekte – Für interaktive Elemente wie CTAs oder vorgestellte Projekte.
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. Horizontale Scroll-Abschnitte – Perfekt für Projektpräsentationen. Vertikal scrollen, aber der Inhalt bewegt sich horizontal.
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,
}
});
Lies references/gsap-patterns.md für fortgeschrittenere Muster, darunter morphing shapes, custom cursor trails, Noise-basierte Bewegungen und WebGL-Integrationshinweise.
Ästhetische Richtung
Für das Portfolio eines Softwareentwicklers funktionieren diese ästhetischen Richtungen am besten. Wähle eine pro Projekt – vermische sie niemals:
1. Terminal Noir
Dunkler Hintergrund, monospaced Schrift gemischt mit einer scharfen serifenlosen Schrift, grüne/gelbe/cyanfarbene Akzente auf Schwarz. Fühlt sich an, als wäre man in einem Terminal – aber einem schönen. Verwende Scanline-Overlays, blinkende Cursor, Tipp-Animationen. Denk an: Hacker-Ästhetik trifft Editorial Design.
2. Brutalist Code
Rohe, offene Struktur. Sichtbare Gitterlinien, große monospaced Schrift, harter Kontrast. Elemente wirken, als wären sie absichtlich mit position: absolute platziert worden. Animationen sind kurz und mechanisch – kein ease-out, verwende steps() oder power4.inOut. Denk an: als hätte ein Compiler Geschmack.
3. Soft Engineering
Helle Hintergründe mit warmen Neutraltönen, großzügiger Weißraum, elegante Serifenschrift für Überschriften kombiniert mit einer sauberen serifenlosen Schrift. Sanfte, fließende Animationen. Wirkt erstklassig und ruhig. Denk an: als hätte Dieter Rams ein Portfolio entworfen.
4. Neon Architect
Dunkle Basis, leuchtende Neon-Akzente (Magenta, Elektroblau, Limette), Glas-Morphismus, Glow-Effekte. Animationen sind flüssig und wirken fast flüssig. Gitternetzbasiertes Layout mit überlappenden Elementen. Denk an: Blade Runner trifft Schweizer Design.
5. Analog Digital
Papierstrukturen, handgezeichnete Elemente gemischt mit scharfer digitaler Schrift, subtile Kornüberlagerungen. Warme Farbpalette. Animationen ahmen physische Bewegungen nach – Dinge gleiten wie Papier, stapeln sich wie Karten. Denk an: ein Entwickler, der auch skizziert.
Abschnittsarchitektur
Ein starkes Portfolio folgt dieser Struktur. Jeder Abschnitt sollte sich wie eine eigene 'Szene' anfühlen:
Hero
Die ersten 3 Sekunden sind am wichtigsten. Beginne mit einer Textanimation – der Besucher sollte deinen Namen zum Leben erwachen sehen. Füge eine subtile Hintergrundanimation hinzu (schwebende Partikel, sich verwandelnde Formen, Farbverlaufsanimation). Halte die Botschaft toteneinfach: Name + Identität in einem Satz.
Über mich / Philosophie
Zähle nicht nur Fakten auf. Drücke eine Weltanschauung aus. Verwende eine scrollgesteuerte Einblendung, um Text Zeile für Zeile zu enthüllen. Ein Foto ist optional, aber falls vorhanden, verwende eine kreative Behandlung (Duoton, Clip-Path-Reveal, Parallax-Versatz).
Fähigkeiten / Tech-Stack
Verwende NIEMALS ein langweiliges Raster von Logos. Versuche stattdessen: eine orbitale Visualisierung, einen laufenden Ticker/Marquee, interaktive Tags, die auf Hover reagieren, eine Konstellationskarte oder eine Terminal-ähnliche Liste, die sich selbst 'schreibt'.
Projekte
Das Herzstück. Jedes Projekt braucht Atemraum. Verwende entweder: horizontale Scroll-Galerie, vollbildgestapelte Karten, die pinnen und übergehen, oder erweiterbare Karten mit scrollgesteuerten Einblendungen. Jedes Projekt sollte zeigen: Titel, kurze Beschreibung, verwendete Technologien und ein visuelles Element (Screenshot, Video oder kreative Illustration).
Kontakt / Footer
Beende mit Absicht. Ein großer typografischer CTA, vielleicht eine zeitbasierte Begrüßung ('Guten Abend – lass uns reden'), und saubere Kontaktlinks. Halte es prägnant.
Lies references/portfolio-sections.md für detaillierte HTML/CSS/JS-Vorlagen für jeden Abschnittstyp.
Typografie-Regeln
Importiere Schriftarten von Google Fonts. Verwende niemals Systemschriften oder Inter/Roboto.
Gute Paarungen für Entwickler-Portfolios:
- Anzeige + Text: 'Clash Display' + 'Satoshi' (über fontshare.com CDN)
- Anzeige + Text: 'Syne' + 'Work Sans' (Google Fonts)
- Anzeige + Text: 'Space Grotesk' + 'DM Sans' (Google Fonts) – nur für einen technischen Vibe
- Monospaced + Serifenlos: 'JetBrains Mono' + 'General Sans' (fontshare) – für die Terminal-Ästhetik
- Serifen + Serifenlos: 'Playfair Display' + 'Source Sans 3' – für die weiche/hochwertige Richtung
- Anzeige + Text: 'Anybody' + 'Instrument Sans' (Google Fonts)
- Anzeige + Text: 'Bricolage Grotesque' + 'Geist' (via CDN)
Lade 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">
oder
<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">
Farbregeln
Definiere eine Palette mit CSS-Custom-Properties. Jede Palette benötigt:
--bg: Haupthintergrund--fg: Haupttext--accent: Primäre Akzentfarbe--accent-2: Sekundäre Akzentfarbe (optional)--muted: Gedämpfter Text/Rahmen--surface: Karten-/Abschnittshintergrund
Beispiel (Terminal Noir):
:root {
--bg: #0a0a0a;
--fg: #e8e8e8;
--accent: #00ff88;
--accent-2: #0088ff;
--muted: #333;
--surface: #111;
}
Beispiel (Soft Engineering):
:root {
--bg: #f8f5f0;
--fg: #1a1a1a;
--accent: #c45d3e;
--accent-2: #2d5a7b;
--muted: #b8b0a4;
--surface: #ffffff;
}
Performance-Regeln
GSAP ist standardmäßig performant, aber befolge diese Regeln:
- Verwende
will-change: transformauf animierten Elementen - Bevorzuge
transformundopacityvor Layout-Eigenschaften (width, height, top, left) - Verwende
ScrollTrigger.batch()für viele ähnliche Elemente anstelle einzelner Trigger - Füge
loading="lazy"zu Bildern unter dem Falz hinzu - Halte das Gesamtgewicht der Seite unter 2 MB (ohne Videos)
- Verwende
gsap.matchMedia(), um schwere Animationen auf Mobilgeräten zu deaktivieren:
gsap.matchMedia().add('(max-width: 768px)', () => {
// Einfachere mobile Animationen hier
});
Reaktionsfähigkeit
Jeder Abschnitt muss auf Mobilgeräten funktionieren. Wichtige Regeln:
- Schriftgrößen: Verwende
clamp()für fließende Skalierung – z. B.clamp(2rem, 5vw, 5rem) - Horizontale Scroll-Abschnitte sollten auf Mobilgeräten zur vertikalen Stapelung übergehen
- Fixierte Abschnitte: Reduziere die Pin-Dauer oder entferne das Pin auf Mobilgeräten via
gsap.matchMedia() - Touch-Ziele: Schaltflächen/Links mindestens 44px
- Teste bei den Breakpoints 375px, 768px, 1440px
Barrierefreiheit
Animierte Portfolios müssen trotzdem barrierefrei sein:
- Respektiere
prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
gsap.globalTimeline.timeScale(0); // oder Animationen ganz überspringen
}
- Semantisches HTML: Verwende
<main>,<section>,<nav>,<header>,<footer> - Alt-Texte auf allen Bildern
- Mit Tastatur navigierbare interaktive Elemente
- Ausreichender Farbkontrast (mindestens 4.5:1 für Fließtext)
Beim Erstellen
- Beginne mit der ästhetischen Richtung – bestätige mit dem Benutzer oder wähle basierend auf seinem Vibe
- Baue die HTML-Struktur mit semantischen Abschnitten
- Style mit CSS (Custom Properties, fließende Schrift, Grid/Flexbox)
- Füge GSAP-Animationen Abschnitt für Abschnitt hinzu
- Füge ScrollTrigger für scrollgesteuerte Einblendungen hinzu
- Füge Interaktivität hinzu (Hover-Zustände, Cursor-Effekte, Mikrointeraktionen)
- Mache es reaktionsfähig
- Füge
prefers-reduced-motion-Handling hinzu - Optimiere (Lazy Loading, will-change, matchMedia für Mobilgeräte)
Gebe immer eine einzelne HTML-Datei mit eingebettetem CSS und JS aus, es sei denn, der Benutzer gibt ein Framework an.