Habilidad de Portafolio GSAP
Construye sitios web de portafolio que parezcan hechos por un estudio creativo, pero con el alma de un ingeniero de software. El objetivo nunca es un "portafolio corporativo con héroe y tarjetas". El objetivo es una experiencia que haga que alguien deje de desplazarse.
Filosofía
Los portafolios de desarrolladores fallan de dos maneras: o son aburridos (página blanca, cuadrícula de tarjetas, "Hola, soy un desarrollador") o se esfuerzan demasiado con efectos que se sienten desconectados del contenido. El punto óptimo es el drama intencional: cada animación debe sentirse como si estuviera revelando algo, no solo moviéndose por moverse.
Piensa en el portafolio como una narrativa, no como una página. El visitante está siendo guiado a través de una historia: quién eres → qué has construido → cómo piensas → cómo contactarte.
Integración GSAP
Siempre carga GSAP desde una CDN. Usa la última versión desde la CDN de GSAP (no 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>
Para proyectos React, instala mediante npm:
npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
Patrones GSAP Básicos para Usar
1. Revelaciones Escalonadas: El pan de cada día. Nunca reveles un grupo de elementos de una sola vez.
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. Animaciones de Texto Dividido: Divide los encabezados en caracteres/palabras y anímalos. Esta es la animación de mayor impacto que puedes agregar. Usa el plugin SplitText si está disponible, o divide manualmente con spans:
// División manual de caracteres
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. Fijación por Desplazamiento: Fija secciones y anima el contenido dentro de ellas mientras el usuario se desplaza. Crea esa sensación "cinematográfica".
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. Capas de Paralaje: Dale profundidad con diferentes velocidades de desplazamiento.
gsap.to('.bg-layer', {
yPercent: -30,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true,
}
});
5. Efectos Magnéticos / Seguimiento del Cursor: Para elementos interactivos como CTA o proyectos destacados.
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. Secciones de Desplazamiento Horizontal: Perfecto para vitrinas de proyectos. Te desplazas verticalmente pero el contenido se mueve horizontalmente.
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,
}
});
Lee references/gsap-patterns.md para patrones más avanzados como formas en morphing, estelas de cursor personalizadas, movimiento basado en ruido y sugerencias de integración WebGL.
Dirección Estética
Para el portafolio de un ingeniero de software, estas direcciones estéticas funcionan mejor. Elige una por proyecto — nunca las mezcles:
1. Terminal Noir
Fondo oscuro, tipografía monoespaciada combinada con una sans-serif definida, acentos verde/ámbar/cian sobre negro. Se siente como si estuvieras dentro de una terminal — pero una hermosa. Usa superposiciones de líneas de escaneo, cursores parpadeantes, animaciones de escritura. Piensa: estética hacker con diseño editorial.
2. Brutalist Code
Estructura cruda y expuesta. Cuadrículas visibles, tipografía mono grande, contraste agresivo. Los elementos parecen colocados con position: absolute a propósito. Las animaciones son rápidas y mecánicas — sin ease-out, usa steps() o power4.inOut. Piensa: si un compilador tuviera buen gusto.
3. Soft Engineering
Fondos claros con neutros cálidos, espacios en blanco generosos, serifa elegante para encabezados combinada con una sans-serif limpia. Animaciones suaves y fluidas. Se siente premium y tranquilo. Piensa: si Dieter Rams diseñara un portafolio.
4. Neon Architect
Base oscura, acentos neón vibrantes (magenta, azul eléctrico, lima), glassmorphism, efectos de brillo. Animaciones fluidas y casi líquidas. Diseño basado en cuadrícula con elementos superpuestos. Piensa: Blade Runner se encuentra con el diseño suizo.
5. Analog Digital
Texturas de papel, elementos dibujados a mano combinados con tipografía digital definida, superposiciones sutiles de grano. Paleta de colores cálidos. Las animaciones imitan el movimiento físico: las cosas se deslizan como papel, se apilan como tarjetas. Piensa: un desarrollador que también dibuja.
Arquitectura de Secciones
Un portafolio sólido sigue esta estructura. Cada sección debe sentirse como su propia "escena":
Héroe
Los primeros 3 segundos son los más importantes. Comienza con animación de texto: el visitante debe verte cobrar vida. Incluye una animación ambiental sutil en el fondo (partículas flotantes, formas morphing, animación de degradado). Mantén el mensaje simple: Nombre + identidad en una línea.
Sobre Mí / Filosofía
No solo enumeres hechos. Expresa una visión del mundo. Usa una revelación por desplazamiento para mostrar el texto línea por línea. Una foto es opcional, pero si se incluye, usa un tratamiento creativo (duotono, revelación con clip-path, desplazamiento de paralaje).
Habilidades / Stack Tecnológico
NUNCA uses una cuadrícula aburrida de logotipos. En su lugar, prueba: una visualización orbital, un ticker/marquee con desplazamiento, etiquetas interactivas que reaccionan al hover, un mapa de constelaciones, o una lista estilo terminal que se "escribe" a sí misma.
Proyectos
La pieza central. Cada proyecto necesita espacio para respirar. Usa: galería de desplazamiento horizontal, tarjetas apiladas a pantalla completa que se fijan y transicionan, o tarjetas expandibles con revelaciones por desplazamiento. Cada proyecto debe mostrar: título, descripción breve, tecnologías usadas y un visual (captura de pantalla, video o ilustración creativa).
Contacto / Pie de Página
Termina con intención. Un gran CTA tipográfico, quizás un saludo basado en la hora ("Buenas noches — hablemos"), y enlaces de contacto limpios. Que sea contundente.
Lee references/portfolio-sections.md para plantillas detalladas de HTML/CSS/JS para cada tipo de sección.
Reglas Tipográficas
Importa fuentes desde Google Fonts. Nunca uses fuentes del sistema ni Inter/Roboto.
Buenas combinaciones para portafolios de desarrolladores:
- Display + Body: "Clash Display" + "Satoshi" (vía fontshare.com CDN)
- Display + Body: "Syne" + "Work Sans" (Google Fonts)
- Display + Body: "Space Grotesk" + "DM Sans" (Google Fonts) — solo si buscas un vibe tecnológico
- Mono + Sans: "JetBrains Mono" + "General Sans" (fontshare) — para estética terminal
- Serif + Sans: "Playfair Display" + "Source Sans 3" — para la dirección suave/premium
- Display + Body: "Anybody" + "Instrument Sans" (Google Fonts)
- Display + Body: "Bricolage Grotesque" + "Geist" (vía CDN)
Carga mediante:
<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">
o
<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">
Reglas de Color
Define una paleta usando propiedades personalizadas de CSS. Cada paleta necesita:
--bg: fondo principal--fg: texto principal--accent: color de acento primario--accent-2: acento secundario (opcional)--muted: texto atenuado / bordes--surface: fondos de tarjetas/secciones
Ejemplo (Terminal Noir):
:root {
--bg: #0a0a0a;
--fg: #e8e8e8;
--accent: #00ff88;
--accent-2: #0088ff;
--muted: #333;
--surface: #111;
}
Ejemplo (Soft Engineering):
:root {
--bg: #f8f5f0;
--fg: #1a1a1a;
--accent: #c45d3e;
--accent-2: #2d5a7b;
--muted: #b8b0a4;
--surface: #ffffff;
}
Reglas de Rendimiento
GSAP es eficiente por defecto, pero sigue estas:
- Usa
will-change: transformen elementos animados - Prefiere
transformyopacitysobre propiedades de layout (width, height, top, left) - Usa
ScrollTrigger.batch()para muchos elementos similares en lugar de activadores individuales - Agrega
loading="lazy"a las imágenes debajo del pliegue - Mantén el peso total de la página por debajo de 2MB (excluyendo videos)
- Usa
gsap.matchMedia()para deshabilitar animaciones pesadas en móvil:
gsap.matchMedia().add('(max-width: 768px)', () => {
// Animaciones móviles más simples aquí
});
Responsividad
Cada sección debe funcionar en móvil. Reglas clave:
- Tamaños de fuente: usa
clamp()para escalado fluido — ej.,clamp(2rem, 5vw, 5rem) - Las secciones de desplazamiento horizontal deben convertirse en apilamiento vertical en móvil
- Secciones fijas: reduce la duración de fijación o elimínala en móvil mediante
gsap.matchMedia() - Objetos táctiles: botones/enlaces de al menos 44px
- Prueba en los puntos de quiebre 375px, 768px, 1440px
Accesibilidad
Los portafolios animados aún deben ser accesibles:
- Respeta
prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
gsap.globalTimeline.timeScale(0); // o salta las animaciones por completo
}
- HTML semántico: usa
<main>,<section>,<nav>,<header>,<footer> - Texto alternativo en todas las imágenes
- Elementos interactivos navegables por teclado
- Contraste de color suficiente (4.5:1 mínimo para texto del cuerpo)
Al Construir
- Comienza con la dirección estética — confírmala con el usuario o elige basándote en su estilo
- Construye la estructura HTML con secciones semánticas
- Aplica estilo con CSS (propiedades personalizadas, tipografía fluida, grid/flexbox)
- Agrega animaciones GSAP sección por sección
- Añade ScrollTrigger para revelaciones por desplazamiento
- Agrega interactividad (estados hover, efectos de cursor, micro-interacciones)
- Hazlo responsivo
- Agrega manejo de
prefers-reduced-motion - Optimiza (carga diferida, will-change, matchMedia para móvil)
Siempre genera un único archivo HTML con CSS y JS incrustados a menos que el usuario especifique un framework.