Como montar um bom currículo e portfólio de programador

Equipe Hcode16 de outubro de 202610 min de leitura

Neste artigo

Um bom currículo de programador cabe em uma página, mostra resultados e leva a pessoa que lê até o seu portfólio. Um bom portfólio tem poucos projetos, bem explicados, com o código no GitHub e uma demonstração que funciona. Os dois se complementam: o currículo faz alguém querer ver o seu trabalho, e o portfólio prova o que o currículo afirma.

Se você está começando e ainda não tem experiência registrada em carteira, este guia é para você. Vamos montar o currículo passo a passo, depois o portfólio, e terminar com um checklist para conferir tudo antes de enviar a primeira candidatura.

O que quem contrata procura primeiro

Quem lê muitos currículos faz uma primeira leitura rápida atrás do essencial: o cargo que você busca, as tecnologias que você usa, a experiência ou os projetos mais recentes e um jeito fácil de falar com você. O resto só é lido se essa primeira passada convencer.

Isso muda o jeito de escrever. Cada linha precisa ajudar a pessoa a decidir se vale a pena chamar você para uma conversa. O que não ajuda atrapalha, porque esconde o que importa.

Como montar um bom currículo de programador

1. Use uma página só

No início de carreira, uma página é suficiente e é o que a maioria dos recrutadores prefere ler. Mais do que isso costuma significar que você incluiu informação que não ajuda. Quando precisar cortar, tire o que não tem relação com a vaga.

2. Siga uma estrutura simples

Uma ordem que funciona para quem está começando:

Nome Sobrenome
Desenvolvedora Front-end Júnior | São Paulo, SP (aceito remoto)
[email protected] | linkedin.com/in/seu-perfil | github.com/seu-usuario | seusite.dev

RESUMO
2 ou 3 linhas: quem você é, com o que trabalha e o que busca.

HABILIDADES TÉCNICAS
Linguagens: JavaScript, TypeScript, HTML, CSS
Frameworks: React, Node.js
Ferramentas: Git, GitHub, Docker, Figma

PROJETOS
Nome do projeto: o que faz, tecnologias e resultado. Link do GitHub e da demonstração.

EXPERIÊNCIA
Cargo, empresa, período, e o que você entregou.

FORMAÇÃO E CURSOS
Curso, instituição, ano.

Se você tem pouca experiência profissional, coloque Projetos antes de Experiência. Quem tem mais tempo de carreira faz o contrário.

3. Escreva resultados, não só tarefas

Uma lista de tarefas diz o que você fazia. Um resultado diz o que mudou por causa do seu trabalho. Use esta fórmula: verbo de ação, o que você fez, a tecnologia e o resultado.

Fraco:  Responsável por desenvolver telas do sistema.

Melhor: Desenvolvi 12 telas em React com TypeScript e reduzi de 5 para 2
        minutos o tempo de cadastro de clientes.

Os números do exemplo são ilustrativos. Use os seus, e quando não souber o número exato, descreva o efeito: "deixou o carregamento mais rápido", "eliminou um erro que travava o login". Nunca invente métricas, porque você pode ser questionado sobre elas em uma entrevista.

4. Liste habilidades com honestidade

Agrupe as habilidades por tipo (linguagens, frameworks, ferramentas) e inclua só o que você consegue explicar e usar. Evite barras de nível, estrelas ou porcentagens: ninguém sabe o que "80% de JavaScript" significa. Se uma tecnologia aparece no currículo, espere que perguntem sobre ela.

5. Sem experiência? Mostre prática

Quando você ainda não teve o primeiro emprego na área, o que entra no lugar da experiência é prática comprovável:

  • Projetos pessoais publicados no GitHub, com demonstração online
  • Cursos com certificado, citando o que você construiu neles
  • Contribuições em projetos de código aberto, mesmo que pequenas
  • Trabalhos voluntários, freelas e projetos para amigos ou para a sua comunidade
  • Hackathons, desafios e competições de programação

Quer montar ou melhorar o seu currículo? Crie o seu na Hcode Class e confira se ele está organizado, claro e pronto para enviar.

6. Adapte o currículo para cada vaga

Leia a descrição da vaga e destaque no seu currículo as tecnologias e as responsabilidades que combinam com o que você já fez. Não precisa reescrever tudo: ajuste o resumo, a ordem das habilidades e os projetos que aparecem primeiro. Alguns sistemas de seleção leem o texto do arquivo, então use as mesmas palavras da vaga quando elas forem verdadeiras para você.

7. Cuide do formato

  • Envie em PDF, com texto selecionável, a menos que a vaga peça outro formato.
  • Nomeie o arquivo de forma clara, como nome-sobrenome-curriculo.pdf.
  • Use uma fonte legível, títulos claros e bastante espaço em branco. Evite colunas complicadas, ícones demais e texto dentro de imagens.
  • Deixe os links clicáveis e teste todos antes de enviar.
  • Use um e-mail profissional, de preferência com o seu nome.
  • Foto, CPF, RG e estado civil não são necessários. Informe só o que ajuda na candidatura.
  • Revise o português. Um erro de digitação no cabeçalho passa a impressão de falta de cuidado.

Erros comuns no currículo

  • Mais de uma página no início de carreira: o essencial se perde no meio do texto.
  • Objetivo genérico: "buscar uma oportunidade de crescimento" não diz nada. Escreva o cargo e a área.
  • Lista de tecnologias sem prova: cada habilidade deveria aparecer também em um projeto ou em uma experiência.
  • Mesmo currículo para todas as vagas: a pessoa que lê percebe quando ele não foi pensado para aquela oportunidade.
  • Links quebrados ou sem destaque: se o GitHub e o portfólio não estão visíveis, você perde a melhor parte da sua candidatura.

Como montar um bom portfólio de desenvolvedor

O portfólio é a vitrine do seu trabalho. É onde alguém confere, na prática, o que o currículo promete. Para quem está começando, uma combinação simples resolve: um perfil organizado no GitHub, com o código dos projetos, e uma página própria, um site simples hospedado gratuitamente, com a apresentação e os links.

1. Escolha de 3 a 5 projetos

Qualidade vale mais do que quantidade. Três projetos completos e bem explicados impressionam mais do que quinze incompletos. Escolha projetos que mostrem habilidades diferentes:

  • Um aplicativo com cadastro, login e banco de dados, que mostra que você sabe montar um sistema completo
  • Um projeto que consome uma API e trata erros e carregamento
  • Um projeto com testes automatizados
  • Um projeto publicado na internet, com endereço que qualquer pessoa pode abrir

Projetos feitos seguindo um curso têm valor, mas evite publicar a cópia exata do tutorial. Acrescente algo seu, como uma funcionalidade nova, um visual diferente ou uma regra de negócio própria, e explique o que você mudou.

2. Conte o problema, a solução e a tecnologia

Para cada projeto, responda a três perguntas em poucas linhas: que problema ele resolve, como você resolveu e com quais tecnologias. Um cartão de projeto simples já resolve:

Controle de Gastos
Aplicativo web para registrar e categorizar despesas mensais.
Resolve: quem anota gastos em planilhas e perde o controle no fim do mês.
Stack: React, TypeScript, Node.js, PostgreSQL.
Destaque: gráficos por categoria e alerta ao passar do limite definido.
Links: demonstração | código no GitHub

3. Capriche no README

O README é a primeira coisa que alguém vê ao abrir o repositório. Um README bem feito vale mais do que um código bonito que ninguém sabe como rodar. Uma estrutura que funciona:

# Nome do projeto

Uma frase dizendo o que o projeto faz.

![Captura de tela](docs/tela.png)

## Demonstração
Link para o projeto no ar.

## Tecnologias
React, TypeScript, Node.js, PostgreSQL

## Como rodar
1. git clone ...
2. npm install
3. copie .env.example para .env e preencha
4. npm run dev

## Decisões técnicas
Por que escolhi cada ferramenta e o que faria diferente.

## Próximos passos
O que ainda quero melhorar.

4. Deixe o projeto rodando

Quem avalia o seu portfólio não vai instalar nada para ver se funciona. Coloque cada projeto no ar e deixe o link no README e no currículo. As instruções para rodar localmente também precisam funcionar de verdade: teste em uma pasta limpa, seguindo só o que está escrito.

Um cuidado importante: nunca publique senhas, tokens ou chaves de API no repositório. Use variáveis de ambiente, mantenha o arquivo .env fora do Git e inclua um .env.example só com os nomes das variáveis. Se algum segredo já foi publicado, troque-o imediatamente.

5. Cuide do código e do histórico

Quem tem experiência olha o repositório com atenção. Mantenha as pastas organizadas, use nomes claros, escreva mensagens de commit que expliquem a mudança e apague o código que não está em uso. Alguns testes e um linter configurado mostram maturidade, mesmo em projetos pequenos.

6. Organize o seu perfil no GitHub e no LinkedIn

  • No GitHub, use foto, nome e uma bio curta, e fixe no perfil os 3 a 6 repositórios que você quer mostrar.
  • Crie o README do perfil (um repositório com o seu nome de usuário) com uma apresentação rápida e os links principais.
  • No LinkedIn, mantenha cargo, resumo e projetos coerentes com o currículo, com link para o portfólio.
  • Se for configurar o acesso ao GitHub pelo terminal, veja como adicionar uma chave SSH ao GitHub.

7. Monte um site simples de portfólio

Uma página com quatro blocos basta: quem é você, os projetos (com o cartão de cada um), as tecnologias que você usa e o contato. Ela precisa carregar rápido, funcionar bem no celular e ter links que abrem. Você pode publicá-la gratuitamente, por exemplo, com hospedagem no Firebase Hosting e domínio .com.br.

Erros comuns no portfólio

  • Projetos demais e todos incompletos: prefira poucos, mas finalizados.
  • Repositório sem README: quem abre não entende o que é nem como ver funcionando.
  • Nomes como "teste1" e "projeto-final-v2": nomes claros mostram organização.
  • Projeto que não abre: o link do deploy fora do ar passa a impressão de abandono.
  • Segredos publicados no código: além do risco de segurança, é um sinal de alerta para quem avalia.

Como currículo e portfólio trabalham juntos

Os dois precisam contar a mesma história. Os projetos que aparecem no currículo são os mesmos que aparecem no portfólio, com o mesmo nome, a mesma descrição curta e links diretos. O currículo resume e o portfólio detalha. Deixe o link do portfólio e do GitHub no cabeçalho do currículo e, em cada candidatura, escolha os projetos mais próximos da vaga para ir primeiro.

Atualize os dois a cada projeto novo ou tecnologia aprendida. Um portfólio parado há dois anos pesa contra você.

Checklist final antes de enviar

  • ☐ O currículo tem uma página, em PDF, com texto selecionável
  • ☐ O cabeçalho tem cargo desejado, e-mail profissional, LinkedIn, GitHub e portfólio
  • ☐ Cada experiência ou projeto mostra resultado, não só tarefa
  • ☐ Todas as habilidades listadas aparecem em algum projeto ou experiência
  • ☐ O currículo foi adaptado para a vaga
  • ☐ Todos os links foram testados
  • ☐ O portfólio tem de 3 a 5 projetos finalizados
  • ☐ Cada projeto tem README, demonstração no ar e instruções que funcionam
  • ☐ Nenhum segredo (senha, token ou chave) está no repositório
  • ☐ O perfil do GitHub e o do LinkedIn estão organizados e coerentes com o currículo

Próximos passos

Escolha um projeto seu e escreva hoje o README completo. Depois monte o currículo de uma página com a estrutura deste guia e peça para alguém de confiança ler e dizer o que entendeu em poucos segundos. Ajuste o que gerar dúvida, publique e comece a se candidatar.

Para continuar aprendendo, conheça a plataforma de cursos da Hcode e acompanhe os próximos guias de carreira no blog.

Perguntas frequentes

Devo colocar foto no currículo?

Não é necessário. Foto, CPF, RG e estado civil não ajudam na candidatura. Informe só o que mostra que você é a pessoa certa para a vaga.

Quantos projetos devo ter no portfólio?

De 3 a 5 projetos finalizados, com README, demonstração no ar e código no GitHub. Poucos projetos bem explicados valem mais do que muitos incompletos.

Projetos feitos em curso valem no portfólio?

Valem, desde que você acrescente algo seu (uma funcionalidade nova, outro visual ou uma regra de negócio própria) e explique o que mudou em relação ao tutorial.

Currículo em PDF ou em Word?

PDF, com texto selecionável, a menos que a vaga peça outro formato. Ele mantém a formatação em qualquer dispositivo.

Preciso ter um site de portfólio ou só o GitHub basta?

Para começar, um GitHub organizado, com os repositórios principais fixados e bons READMEs, já ajuda muito. Um site simples é um complemento, mas não é obrigatório.

Como montar o currículo sem experiência profissional?

Coloque Projetos antes de Experiência e mostre prática comprovável: projetos publicados, cursos com o que você construiu, contribuições em código aberto, freelas e hackathons.

Continue aprendendo com a Hcode

Cadastre-se na plataforma de cursos e acompanhe os próximos guias do blog.