Habilidade de Portfólio com GSAP
Crie sites de portfólio que pareçam ter sido feitos por um estúdio criativo — mas com a alma de um engenheiro de software. O objetivo nunca é "portfólio corporativo de desenvolvedor com herói e cards". O objetivo é uma experiência que faça alguém parar de rolar a página.
Filosofia
Os portfólios de desenvolvedores falham de duas maneiras: ou são entediantes (página branca, grade de cards, "Oi, sou um desenvolvedor") ou tentam demais com efeitos que parecem desconectados do conteúdo. O ponto ideal é o drama proposital — cada animação deve parecer que está revelando algo, não apenas se movendo por si só.
Pense no portfólio como uma narrativa, não uma página. O visitante está sendo guiado por uma história: quem você é → o que você construiu → como você pensa → como entrar em contato.
Integração com GSAP
Sempre carregue o GSAP a partir de uma CDN. Use a versão mais recente da CDN do GSAP (não a 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 projetos React, instale via npm:
npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);
Padrões GSAP Principais para Usar
1. Revelações Escalonadas — O pão com manteiga. Nunca revele um grupo de elementos todos de uma 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. Animações de Texto Dividido — Divida títulos em caracteres/palavras e anime-os. Esta é a animação de maior impacto que você pode adicionar. Use o plugin SplitText se disponível, ou divida manualmente com spans:
// Divisão 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. Fixação Acionada por Rolagem — Fixe seções e anime o conteúdo dentro delas conforme o usuário rola. Cria aquela sensação "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. Camadas em Parallax — Dê profundidade com diferentes velocidades de rolagem.
gsap.to('.bg-layer', {
yPercent: -30,
ease: 'none',
scrollTrigger: {
trigger: '.parallax-section',
start: 'top bottom',
end: 'bottom top',
scrub: true,
}
});
5. Efeitos Magnéticos / Seguir Cursor — Para elementos interativos como CTAs ou projetos em destaque.
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. Seções de Rolagem Horizontal — Perfeitas para vitrines de projetos. Role verticalmente, mas o conteúdo se move 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,
}
});
Leia references/gsap-patterns.md para padrões mais avançados, incluindo formas em morphing, rastros de cursor personalizados, movimento baseado em ruído e dicas de integração WebGL.
Direção Estética
Para o portfólio de um engenheiro de software, estas direções estéticas funcionam melhor. Escolha uma por projeto — nunca as misture:
1. Terminal Noir
Fundo escuro, tipo monoespaçado combinado com um sans-serif afiado, acentos verde/ciano/âmbar sobre preto. Parece que você está dentro de um terminal — mas um bonito. Use sobreposições de linhas de varredura, cursores piscantes, animações de digitação. Pense: estética hacker encontra design editorial.
2. Código Brutalista
Estrutura crua e exposta. Linhas de grade visíveis, tipo mono grande, contraste agressivo. Os elementos parecem que foram colocados com position: absolute de propósito. As animações são rápidas e mecânicas — sem ease-out, use steps() ou power4.inOut. Pense: se um compilador tivesse bom gosto.
3. Engenharia Suave
Fundos claros com neutros quentes, espaçamento generoso, serifa elegante para títulos combinada com um sans-serif limpo. Animações suaves e fluidas. Parece premium e calmo. Pense: se Dieter Rams projetasse um portfólio.
4. Arquiteto Neon
Base escura, acentos neon vívidos (magenta, azul elétrico, limão), glassmorfismo, efeitos de brilho. Animações fluidas e quase líquidas. Layout baseado em grade com elementos sobrepostos. Pense: Blade Runner encontra design suíço.
5. Digital Analógico
Texturas de papel, elementos desenhados à mão misturados com tipo digital afiado, sobreposições sutis de grão. Paleta de cores quentes. Animações imitam movimento físico — coisas deslizam como papel, empilham como cartas. Pense: um desenvolvedor que também esboça.
Arquitetura das Seções
Um portfólio forte segue esta estrutura. Cada seção deve parecer sua própria "cena":
Herói
Os primeiros 3 segundos são os mais importantes. Comece com animação de texto — o visitante deve ver seu nome ganhar vida. Inclua uma animação ambiente sutil no fundo (partículas flutuantes, formas em morphing, animação gradiente). Mantenha a mensagem extremamente simples: Nome + identidade em uma linha.
Sobre / Filosofia
Não apenas liste fatos. Expresse uma visão de mundo. Use uma revelação acionada por rolagem para exibir o texto linha por linha. Uma foto é opcional, mas se incluída, use um tratamento criativo (duotone, revelação com clip-path, deslocamento parallax).
Habilidades / Pilha Tecnológica
NUNCA use uma grade chata de logotipos. Em vez disso, tente: uma visualização orbital, um ticker/marquee de rolagem, tags interativas que reagem ao hover, um mapa de constelação ou uma lista estilo terminal que se "digita" sozinha.
Projetos
A peça central. Cada projeto precisa de espaço para respirar. Use: galeria de rolagem horizontal, cartas empilhadas em tela cheia que fixam e fazem transição, ou cartas expansíveis com revelações acionadas por rolagem. Cada projeto deve mostrar: título, breve descrição, tecnologia usada e um visual (captura de tela, vídeo ou ilustração criativa).
Contato / Rodapé
Termine com intenção. Um CTA tipográfico grande, talvez uma saudação baseada no horário ("Boa noite — vamos conversar"), e links de contato limpos. Mantenha impactante.
Leia references/portfolio-sections.md para modelos detalhados de HTML/CSS/JS para cada tipo de seção.
Regras de Tipografia
Importe fontes do Google Fonts. Nunca use fontes do sistema ou Inter/Roboto.
Boas combinações para portfólios de desenvolvedores:
- Display + Corpo: "Clash Display" + "Satoshi" (via fontshare.com CDN)
- Display + Corpo: "Syne" + "Work Sans" (Google Fonts)
- Display + Corpo: "Space Grotesk" + "DM Sans" (Google Fonts) — apenas se for uma vibe tecnológica
- Mono + Sans: "JetBrains Mono" + "General Sans" (fontshare) — para estética de terminal
- Serifa + Sans: "Playfair Display" + "Source Sans 3" — para direção suave/premium
- Display + Corpo: "Anybody" + "Instrument Sans" (Google Fonts)
- Display + Corpo: "Bricolage Grotesque" + "Geist" (via CDN)
Carregue 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">
Regras de Cores
Defina uma paleta usando propriedades personalizadas CSS. Toda paleta precisa de:
--bg: fundo principal--fg: texto principal--accent: cor de destaque primária--accent-2: destaque secundário (opcional)--muted: texto suave / bordas--surface: fundos de cartões/seções
Exemplo (Terminal Noir):
:root {
--bg: #0a0a0a;
--fg: #e8e8e8;
--accent: #00ff88;
--accent-2: #0088ff;
--muted: #333;
--surface: #111;
}
Exemplo (Engenharia Suave):
:root {
--bg: #f8f5f0;
--fg: #1a1a1a;
--accent: #c45d3e;
--accent-2: #2d5a7b;
--muted: #b8b0a4;
--surface: #ffffff;
}
Regras de Desempenho
O GSAP tem bom desempenho por padrão, mas siga estas:
- Use
will-change: transformem elementos animados - Prefira
transformeopacityem vez de propriedades de layout (width, height, top, left) - Use
ScrollTrigger.batch()para muitos elementos semelhantes em vez de gatilhos individuais - Adicione
loading="lazy"a imagens abaixo da dobra - Mantenha o peso total da página abaixo de 2MB (excluindo vídeos)
- Use
gsap.matchMedia()para desabilitar animações pesadas no celular:
gsap.matchMedia().add('(max-width: 768px)', () => {
// Animações móveis mais simples aqui
});
Responsividade
Cada seção deve funcionar no celular. Regras principais:
- Tamanhos de fonte: use
clamp()para dimensionamento fluido — ex.:clamp(2rem, 5vw, 5rem) - Seções de rolagem horizontal devem se converter em empilhamento vertical no celular
- Seções fixadas: reduza a duração da fixação ou remova a fixação no celular via
gsap.matchMedia() - Alvos de toque: botões/links com pelo menos 44px
- Teste nos pontos de quebra 375px, 768px, 1440px
Acessibilidade
Portfólios animados ainda precisam ser acessíveis:
- Respeite
prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
gsap.globalTimeline.timeScale(0); // ou ignore as animações completamente
}
- HTML semântico: use
<main>,<section>,<nav>,<header>,<footer> - Texto alternativo em todas as imagens
- Elementos interativos navegáveis por teclado
- Contraste de cores suficiente (4.5:1 mínimo para texto do corpo)
Ao Construir
- Comece com a direção estética — confirme com o usuário ou escolha com base no estilo dele
- Construa a estrutura HTML com seções semânticas
- Estilize com CSS (propriedades personalizadas, tipo fluido, grid/flexbox)
- Adicione animações GSAP seção por seção
- Adicione ScrollTrigger para revelações acionadas por rolagem
- Adicione interatividade (estados de hover, efeitos de cursor, microinterações)
- Torne responsivo
- Adicione tratamento para
prefers-reduced-motion - Otimize (carregamento preguiçoso, will-change, matchMedia para celular)
Sempre gere um único arquivo HTML com CSS e JS embutidos, a menos que o usuário especifique um framework.