Quando você não tem experiência formal na área de tecnologia, o currículo quase não tem nada para mostrar. Dois ou três cursos online, talvez um bootcamp, mas nenhuma empresa no campo “experiência profissional”. É exatamente nesse momento que o portfólio faz toda a diferença.
Em tech, o portfólio substitui o histórico de empregos. Um recrutador que vê seu GitHub com projetos funcionando, código organizado e README bem escrito tem muito mais base para te avaliar do que alguém que só listou certificados num PDF. Não importa se você tem seis meses de estudo ou dois anos: o que está publicado e funcionando fala mais alto do que qualquer coisa escrita num currículo.
Este guia vai te mostrar como montar um portfólio do zero, quais projetos incluir, como apresentar cada um deles e onde publicar para que recrutadores realmente encontrem e valorizem o seu trabalho.
O que recrutadores realmente olham num portfólio
Existe um mito de que recrutadores passam horas analisando cada linha do seu código. A realidade é diferente: eles têm pouco tempo e muitos candidatos para avaliar. Nos primeiros 60 segundos, eles estão procurando sinais rápidos de que vale a pena continuar olhando.
Estudos de comportamento de recrutadores mostram que a primeira triagem de um portfólio dura entre 30 e 90 segundos. Se o projeto não tem README, o deploy não funciona ou o repositório parece abandonado, o candidato já foi descartado antes de qualquer análise técnica.
O que eles avaliam nessa primeira passagem é bem objetivo. Aqui está o que passa pela cabeça de um recrutador ao abrir seu GitHub:
- O README existe e explica o que o projeto faz?
- Tem link de demo ou deploy funcionando?
- O histórico de commits é consistente ou só tem um commit inicial?
- O código está organizado em pastas que fazem sentido?
- Existe alguma documentação mínima sobre como rodar o projeto localmente?
- As tecnologias usadas são relevantes para a vaga?
- O candidato tem atividade recente no GitHub?
Perceba que nenhum desses pontos exige que você seja um gênio técnico. São todos critérios de organização, comunicação e cuidado. Um projeto simples bem apresentado bate um projeto complexo com repositório bagunçado toda vez.
Quais projetos incluir no portfólio
A pergunta mais comum de quem está começando é: “Mas o que eu vou colocar no portfólio se não fiz nada ainda?” A resposta é: você cria. E não precisa ser nada mirabolante.
Resolver um problema real, mesmo pequeno, impressiona mais que um projeto complexo sem propósito. Uma calculadora de IMC que você fez porque sua academia não tinha, um organizador de tarefas que criou para controlar seus estudos: isso mostra que você usa código para resolver coisas da vida real.
A tabela abaixo organiza os tipos de projeto mais valorizados para quem está no início da carreira, com estimativa de tempo e o impacto que cada um tende a gerar:
| Tipo de Projeto | Tecnologias | Tempo Estimado | Impacto |
|---|---|---|---|
| CRUD completo (lista, cadastro, edição, exclusão) | React ou Vue + API REST | 1 a 2 semanas | Alto para vagas de frontend/fullstack |
| API REST com autenticação | Node.js ou Python + banco de dados | 2 a 3 semanas | Alto para vagas de backend |
| Clone funcional de app conhecido | Qualquer stack | 1 a 2 semanas | Médio, se tiver diferenciais |
| Ferramenta CLI utilitária | Python ou Node.js | 3 a 5 dias | Médio, mostra domínio de lógica |
| Site estático com dados reais | HTML, CSS, JS ou framework leve | 3 a 5 dias | Baixo/médio para vagas de frontend |
| Dashboard com visualização de dados | React + biblioteca de gráficos | 2 a 3 semanas | Alto para vagas que envolvem dados |
| Bot ou automação | Python ou Node.js | 1 semana | Alto, mostra criatividade |
A melhor estratégia é ter pelo menos um projeto que usa as tecnologias que aparecem nas vagas que você está buscando. Se quer vaga de frontend com React, precisa de pelo menos um projeto React no portfólio. Se quer backend com Node.js, precisa mostrar que já construiu uma API.
Não tente cobrir todas as tecnologias ao mesmo tempo. Foque em dois ou três projetos que mostrem profundidade na stack que você quer trabalhar.
Como estruturar cada projeto
O projeto em si é só metade do trabalho. A outra metade é como você o apresenta. Um projeto sem README é como um produto sem embalagem: existe, mas ninguém vai entender o que é.
O README perfeito
Cada repositório do seu portfólio precisa ter um README com pelo menos estas seções:
Título e descrição curta: uma frase que explique o que o projeto faz. Direto ao ponto.
Screenshots ou GIF: imagens valem mais que mil palavras. Um GIF animado mostrando o projeto em funcionamento é ainda melhor.
Tecnologias usadas: liste as principais. Isso ajuda recrutadores que fazem busca por tecnologia específica.
Funcionalidades: três a cinco bullet points das principais coisas que o projeto faz.
Como rodar localmente: passo a passo simples. Clone, instale dependências, configure variáveis de ambiente, rode. Se der erro, o recrutador desiste.
Link do deploy: se o projeto estiver no ar, esse link vai no topo do README e na descrição do repositório.
O que aprendi: opcional, mas poderoso. Um parágrafo sobre o que esse projeto te ensinou mostra que você reflete sobre o aprendizado.
Onde hospedar gratuitamente
Não tem desculpa para projeto sem deploy em 2026. As opções gratuitas são boas e funcionam bem:
Vercel: ideal para projetos frontend com frameworks como Next.js, Astro, Vue ou React puro. Deploy em segundos via GitHub.
Netlify: similar ao Vercel, funciona muito bem para sites estáticos e frameworks modernos. Interface mais simples para configurar variáveis de ambiente.
GitHub Pages: para projetos HTML, CSS e JavaScript puro. Gratuito, integrado ao GitHub, sem configuração extra.
Railway: para projetos de backend que precisam de banco de dados. Tem plano gratuito que cobre bem projetos de portfólio.
Render: alternativa ao Railway, suporta Node.js, Python, Go e outros. Gratuito para projetos simples, mas pode ter cold start lento no plano gratuito.
A regra é simples: todo projeto no portfólio precisa ter um link que funciona quando o recrutador clica. Se o deploy caiu, sobe de novo antes de mandar o currículo.
GitHub Profile: seu portfólio invisível
Muita gente foca tanto nos repositórios que esquece do perfil em si. O perfil do GitHub é a primeira coisa que o recrutador vê quando acessa sua conta, e ele comunica muito antes de qualquer projeto ser aberto.
Aqui estão os elementos que fazem um perfil do GitHub se destacar:
Foto de perfil: use a mesma foto do LinkedIn. Consistência entre plataformas passa profissionalismo. Não precisa ser foto com terno, mas precisa ser uma foto real, com boa iluminação, onde seu rosto aparece.
Bio: escreva em duas linhas o que você faz e o que está buscando. Exemplo: “Dev frontend focado em React e TypeScript. Buscando primeira oportunidade como dev júnior.”
Link do LinkedIn: coloque no campo de website. Facilita o trabalho do recrutador de encontrar mais informações sobre você.
README do perfil: isso é uma feature que muita gente desconhece. Você pode criar um repositório com o mesmo nome do seu usuário e colocar um README lá. Ele aparece na página inicial do seu perfil. Use para se apresentar, listar suas tecnologias e destacar seus melhores projetos.
Repositórios fixados: você pode fixar até seis repositórios no perfil. Escolha seus melhores projetos. Não deixe os repositórios fixados padrão do GitHub ocupar essas posições.
Atividade constante: o gráfico de contribuições (aquele quadradinho verde) comunica frequência de trabalho. Não precisa commitar todo dia, mas ter gaps de meses passa a impressão de que você parou de estudar. Commite seus estudos, não só projetos finalizados.
Erros que arruínam um portfólio
Montar um portfólio é um processo iterativo. Todo mundo comete esses erros no começo. A diferença é aprender antes de mandar o portfólio para uma vaga importante.
- Repositório sem README: o erro mais comum e mais fácil de corrigir
- Deploy que não funciona: teste o link antes de enviar para qualquer recrutador
- Código todo no mesmo arquivo: mesmo que funcione, passa impressão de desorganização
- Commits com mensagens vazias como “ajuste” ou “fix”: use mensagens descritivas
- Repositório com só um commit inicial: mostra que o projeto foi copiado ou feito de uma vez sem iteração
- Projetos iniciados e nunca terminados: repositório com nome “projeto-incrível” e zero código dentro
- Tecnologias desatualizadas ou sem sentido para as vagas que você busca
- Senha ou chave de API exposta no código: além de erro de segurança, elimina você imediatamente
Projetos sem README são a maior red flag de portfólio. Um repositório sem documentação diz ao recrutador que você não se importa com comunicação técnica. E comunicação técnica é uma das habilidades mais valorizadas em devs, especialmente em times remotos.
Antes de compartilhar seu portfólio com alguém, revise cada repositório com os olhos de quem está vendo pela primeira vez. Abra o link de deploy. Leia o README. Se você ficasse confuso ao ver esse projeto de fora, o recrutador vai ficar também.
Com o portfólio pronto, o próximo passo é ter um currículo que complementa o que você construiu.
Crie seu CV com IA gratuitamenteConclusão
Portfólio não é sobre perfeição técnica. É sobre mostrar que você resolve problemas, se comunica bem e continua aprendendo. Três projetos bem apresentados valem mais do que dez repositórios bagunçados.
Comece pelo projeto mais simples que resolve um problema real para você. Coloque um README, sobe o deploy, ajeita o perfil do GitHub. Depois adiciona mais um projeto. Depois mais um. O portfólio cresce com você.
O recrutador não está esperando um desenvolvedor pronto. Está procurando alguém com potencial, disposição para aprender e cuidado no que produz. Isso você pode mostrar agora, independente de onde está na curva de aprendizado.
Veja também: