Communitygithub.com

Site de portfólio

Constrói um portfólio pessoal com identidade para designer, desenvolvedor, fotógrafo, escritor ou freelancer, com estrutura clara, tipo escolhido e movimento contido.

O que é Site de portfólio?

Habilidade reutilizável para um site de portfólio: apresentar a pessoa, mostrar o trabalho e fugir do modelo genérico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MorganMarshall/ZeroSkills/tree/HEAD/skills/zero-web-design-portfolio

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portfólio de Design

Crie um portfólio que faça três coisas bem: apresente a pessoa, mostre seu trabalho com contexto e facilite o contato. Um portfólio não é uma página de destino — os visitantes querem navegar, não ser direcionados. Projete para descoberta.

Trabalhe em três etapas

  1. Planeje. Defina a direção e a estrutura antes de escrever código (veja abaixo).
  2. Construa. Implemente o plano com tokens de design, para que cada cor, tamanho e espaço venham de um sistema único.
  3. Revise. Critique o resultado com base na lista de verificação no final e corrija o que estiver abaixo do esperado.

Se o briefing do usuário nomear um estilo, paleta, fonte ou layout, siga-o exatamente. As palavras deles sempre prevalecem sobre os padrões desta skill.

1. Planeje antes do código

Escreva um plano curto que cubra:

  • Quem é essa pessoa e o que ela faz. O cargo, disciplina, nível de senioridade e quem visitará o site (recrutadores, clientes, colaboradores, outros designers). Se o briefing não disser, proponha uma frase e indique que você assumiu isso.
  • Direção estética. Escolha uma (minimalista editorial, técnica suave, artesanal calorosa, documentário marcante, experimental) e comprometa-se, com uma justificativa de uma linha relacionada ao trabalho da pessoa. O portfólio de um fotógrafo e o de um desenvolvedor front-end devem parecer diferentes.
  • Tokens. Quatro a seis cores nomeadas como valores hexadecimais, as tipografias e seus papéis, a unidade de espaçamento, a escala de raio e o estilo de sombra. Portfólios geralmente se beneficiam de nenhum ou muito leve acento — deixe o trabalho carregar a cor.
  • Ideia para o herói. Abra com quem são e um projeto representativo, ou uma introdução curta de duas linhas com um link para o trabalho. Evite efeitos de digitação animados e imagens de banco de imagens.

Em seguida, verifique o plano em relação ao briefing. Se alguma parte dele é o que você produziria para qualquer solicitação semelhante, mude essa parte e anote o que mudou. Um plano genérico produz um portfólio genérico.

2. Sistema de design

Cor

  • Defina a paleta como propriedades personalizadas CSS em :root: uma escala neutra (fundo, superfície, borda, texto suave, texto), um acento primário e, opcionalmente, um secundário.
  • Portfólios geralmente ficam mais fortes com acento suave ou nenhum. Deixe o trabalho — imagens, capturas de tela, estudos de caso — fornecer a cor. Use o acento apenas para links, estados ativos e um ou dois destaques intencionais.
  • Suporte claro e escuro com prefers-color-scheme redefinindo os tokens, não sobrescrevendo regras individuais.
  • Mantenha contraste de 4,5:1 para texto do corpo e 3:1 para texto grande e bordas da interface.

Tipografia

  • Use no máximo duas famílias. Se duas, dê a elas papéis claramente diferentes (uma face de exibição para o nome e títulos, uma face de texto para leitura).
  • Escolha faces para a disciplina em vez do primeiro padrão que vier à mente e carregue fontes web com font-display: swap e uma pilha de fallback completa.
  • Construa uma escala tipográfica (proporção em torno de 1,2 a 1,333) e torne os títulos fluidos com clamp().
  • Defina o nome da pessoa e os títulos das seções apertados (altura da linha 1,05 a 1,15, espaçamento entre letras ligeiramente negativo em tamanhos grandes). Texto do corpo aberto (16 a 18px, altura da linha 1,5 a 1,7).
  • Mantenha o comprimento da linha entre 45 e 75 caracteres (max-width: 65ch é um bom padrão).

Layout e espaçamento

  • Use uma escala de espaçamento de 4/8px definida como tokens e use-a em todos os lugares.
  • Dê espaço às seções: 80 a 120px de padding vertical no desktop, 48 a 64px no mobile.
  • Limite o container a cerca de 1100 a 1200px e mantenha o texto de leitura mais estreito.
  • Construa mobile-first com CSS grid e flexbox. Tudo deve funcionar a partir de 360px sem rolagem horizontal; imagens largas, código e diagramas rolam dentro de seu próprio container.
  • Varie o ritmo entre as seções (densidade, alinhamento, escala) em vez de repetir um bloco. Alinhe texto longo à esquerda.
  • Use uma grade clara para a galeria de projetos (duas ou três colunas no desktop, uma no mobile). Varie as proporções entre os projetos quando os ativos permitirem — nem todo projeto precisa de um cartão uniforme.

Superfícies e componentes

  • Use um sistema de raio com dois ou três tamanhos, combinado com a hierarquia (menor em inputs e botões, maior em containers).
  • Use bordas de baixo contraste de 1px em vez de sombras pesadas para cartões de projeto. O trabalho do portfólio deve parecer que está na página, não empilhado acima dela.
  • Dê a cada elemento interativo estados de hover, :focus-visible, active e disabled. Nunca remova um contorno sem substituí-lo.
  • Um botão primário por visualização, rotulado especificamente ("Ver projeto", "Entrar em contato"), com um alvo de toque de pelo menos 44px.
  • Cartões de projeto devem mostrar: o título do projeto, um descritor curto (cargo, ano, tecnologia) e a imagem herói ou captura de tela. Sem rótulos genéricos como "Recurso Um".

Movimento

  • Use transições ease-out de 150 a 250ms para mudanças de estado, para que o movimento mostre o que mudou.
  • Prefira um momento orquestrado (uma sequência de carregamento de página ou uma revelação do herói) em vez de animações de entrada em todas as seções.
  • Animar apenas transform e opacity.
  • Respeite prefers-reduced-motion desativando movimentos não essenciais.
  • Para a galeria de projetos, uma escala sutil ao passar o mouse ou revelação de borda é suficiente. Não adicione sobreposições de hover que obscureçam a imagem do projeto.

Imagens e ícones

  • Nunca envie imagens quebradas ou placeholder. Use os ativos fornecidos ou gere blocos CSS/placeholder limpos que sinalizem onde a imagem vai (rotulados com o nome do projeto).
  • Use proporções consistentes para miniaturas de projetos, ou uma grade estilo masonry se os ativos variarem muito.
  • Mantenha um conjunto de ícones com um peso de traço para links sociais e chrome da interface. Escreva texto alternativo significativo.
  • Para estudos de caso, use capturas de tela reais, mockups ou fotos. Sem lorem ipsum e sem esboços de wireframe como trabalho final.

3. Estrutura da página

Um portfólio geralmente segue este arco:

  • Herói: quem são (nome + cargo), uma frase sobre o que fazem ou seu foco atual e um link claro para o trabalho. Detalhes de contato ou links sociais próximos.
  • Trabalho selecionado: uma galeria curada de 4 a 8 projetos. Cada item leva a uma página de detalhes ou seção expandida. Qualidade sobre quantidade.
  • Sobre (opcional): um parágrafo breve sobre histórico, interesses e onde encontrá-los. Uma foto se eles tiverem — espontânea é aceitável, não precisa ser um retrato profissional a menos que queiram.
  • Contato: uma maneira simples de alcançá-los — link de e-mail, formulário de contato ou links para canais preferidos. Torne-o visível sem rolagem no mobile.
  • Rodapé: links sociais (GitHub, LinkedIn, Dribbble, Instagram, etc.), copyright e talvez uma tagline curta.

Páginas de detalhes de projetos / estudos de caso:

  • Nome do projeto, cargo, ano, stack de tecnologia e link para o projeto ao vivo ou repositório.
  • O problema ou contexto em um ou dois parágrafos.
  • Capturas de tela, mockups ou walkthroughs com breves anotações.
  • O que aprenderam ou o que fariam diferente (isso é o que separa portfólios reais de reels de destaque).
  • Um link para o próximo projeto para navegação contínua.

Texto

  • Escreva texto real e específico. Sem lorem ipsum e sem "Recurso Um".
  • Use o nome e cargo reais da pessoa, não uma persona fictícia.
  • Escreva do ponto de vista do visitante em palavras simples, sentença caso e voz ativa.
  • Faça os títulos dos projetos dizerem o que o projeto é, não abstrações inteligentes. "Painel CRM do cliente" vence "Mecanismo de sinergia."
  • Mantenha as descrições dos projetos em duas ou três frases: o que é, o que você fez e o resultado, se houve um.

Base técnica

  • Use HTML semântico (header, nav, main, section, footer), um único h1 e níveis de cabeçalho em ordem.
  • Torne tudo navegável por teclado, adicione um link de pular em páginas longas e use ARIA apenas onde elementos nativos são insuficientes.
  • Inclua a meta tag de viewport, um título, uma descrição e um favicon.
  • Mantenha as dependências mínimas. Um portfólio pequeno pode ser um único arquivo HTML autocontido com CSS e JS inline. Em um projeto existente, siga sua stack e convenções em vez de introduzir novas.
  • Evite mudanças de layout definindo largura e altura ou aspect-ratio na mídia.
  • Link para repositórios externos e demonstrações ao vivo com rótulos claros ("GitHub", "Site ao vivo").

Sinais comuns a evitar

Estes aparecem em portfólios construídos sem um ponto de vista:

  • Um herói genérico "Olá, sou [Nome], um [Cargo]" com uma ilustração de banco de imagens ou avatar pixel art.
  • Barras de habilidade ou barras de porcentagem ("90% HTML", "80% JavaScript"). Ninguém as lê e são sem sentido.
  • Uma grade uniforme de cartões onde cada projeto tem a mesma proporção, sombra e efeito de hover.
  • Uma linha do tempo animada que é difícil de ler no mobile.
  • Todo cartão de projeto com a mesma sobreposição de gradiente ao passar o mouse.
  • Um botão "baixar currículo" que na verdade leva a uma URL do Google Docs.
  • Uma página cheia de links sem trabalho para ver.

Revisão final

Antes de apresentar o trabalho, verifique (com uma captura de tela ou navegador, se disponível):

  • O espaçamento e alinhamento seguem a escala, sem valores desviados.
  • O contraste e anéis de foco passam, e todo estado interativo existe.
  • O layout se mantém em 360px, tablet e desktop.
  • Nada é placeholder, quebrado ou sem rótulo.
  • A galeria de trabalho parece curada, não exaustiva — quatro projetos fortes vencem dez medíocres.
  • Um estranho pode dizer quem a pessoa é, o que faz e como contatá-la em cinco segundos ao ver a página inicial.
  • Cada projeto leva a um lugar real ou uma página de detalhes plausível, e links externos são claramente rotulados.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas