isa beatriz — Início
Todos os projetos

GitHub Profile Builder

Pessoal · 2026 · Concluído

Plataforma open source para editar o perfil do GitHub e montar o README de perfil a partir de templates, com pré-visualização e revisão antes de aplicar qualquer mudança.

Página inicial do GitHub Profile Builder, com o título "Deixe seu perfil do GitHub com a sua cara" e o botão Entrar com GitHub.

Objetivo

Ajudar desenvolvedores a deixar o perfil do GitHub mais apresentável: editar os dados do perfil, montar o README de perfil a partir de templates, conferir a pré-visualização e só então aplicar. Nada muda no GitHub antes da confirmação na tela de revisão.

O que a aplicação faz

  • Cria rascunhos a partir do perfil atual (até 50 por conta), que podem ser renomeados, duplicados e excluídos.
  • Edita nome, bio, empresa, localização, site, usuário do X, e-mail público e links sociais, com prévia do cartão de perfil ao vivo.
  • Gera o README de perfil com três templates (Classic, Minimal e Compact), em inglês ou português, com seções que podem ser ligadas, desligadas e reordenadas.
  • Oferece um catálogo de 200 tecnologias, até 6 repositórios públicos como projetos, ícones para 25 redes de contato e até 5 seções personalizadas.
  • Mostra uma tela de revisão com o que muda em cada parte, com o README atual e o novo lado a lado.

Decisões técnicas

  • Nada muda sem confirmação. Perfil, links sociais e README são enviados à API do GitHub separadamente e conferidos logo em seguida. O sucesso só é informado quando a mudança aparece no GitHub; se algo falha, a tela mostra o que foi aplicado e o que não foi.
  • Prévia fiel ao resultado. Uma única função gera o README, a mesma usada na publicação, então a prévia é exatamente o que vai para o GitHub. A renderização usa a própria API de Markdown do GitHub.
  • Token fora do banco. O login usa GitHub OAuth e o token de acesso fica apenas no cookie de sessão criptografado (iron-session), nunca no banco. Os rascunhos ficam no PostgreSQL (Neon) com Drizzle ORM, ligados ao ID da conta do GitHub.
  • Permissões mínimas. Apenas os escopos user, para editar o perfil e ler e-mails verificados, e public_repo, para criar e atualizar o repositório público do README.
  • Interface bilíngue. Português e inglês com next-intl, idioma guardado em cookie e temas claro e escuro que seguem o sistema.

Qualidade e publicação

  • Testes com Vitest para geração do README, planejamento e execução das mudanças, cliente da API do GitHub, OAuth e rascunhos.
  • Publicado na Vercel, na região gru1 (São Paulo).
  • Código aberto sob licença MIT.

Vamos conversar?

Para vagas ou projetos freelance, me envie uma mensagem.

E-mail

até mais! :)