github-unfollowers

GitHub Unfollowers [![Chrome Web Store](https://img.shields.io/badge/Chrome%20Web%20Store-Instale%20gr%C3%A1tis-4285F4?style=flat-square&logo=googlechrome&logoColor=white)](https://chromewebstore.google.com/detail/github-unfollowers/lhjcplbgbldjcefdnlnjcogincpgdjjc) [![Manifest V3](https://img.shields.io/badge/Manifest-V3-blue?style=flat-square&logo=googlechrome)](https://developer.chrome.com/docs/extensions/mv3/intro/) [![GitHub API](https://img.shields.io/badge/GitHub-REST%20API-black?style=flat-square&logo=github)](https://docs.github.com/en/rest) [![Licença: MIT](https://img.shields.io/badge/Licença-MIT-green?style=flat-square)](LICENSE)

GitHub Unfollowers utiliza a API oficial do GitHub para analisar suas conexões — sem servidores de terceiros, sem coleta de dados. Tudo acontece localmente no seu navegador.

Gerencie sua rede do GitHub sem sair do navegador.

Funcionalidades

### Listas e Análise - Identifique quem não te segue de volta - Veja quem te segue mas você não segue - Visualize seguidores mútuos - Comparativo histórico com badge "Novo" - Detecção automática de perfis inacessíveis ### Ações e Controle - Deixe de siga / Siga diretamente pela extensão - Ações em massa com confirmação - Retomada automática de ações interrompidas - Whitelist de usuários ignorados - Histórico de eventos (follow, unfollow, inacessível) - Export/import de dados como JSON
### Interface - Tema dark/light com alternância - Busca por username em tempo real - Links diretos para o perfil de cada usuário - Badge no ícone com novos não-seguidores - **Suporte a 16 idiomas com deteção automática** - **Seletor de idioma com pesquisa** ### Técnico - Cache local com Chrome Storage API - Rate-limit awareness com retry automático - Virtual scroll para listas grandes (50+) - Atalhos de teclado e navegação por setas - Acessibilidade com ARIA roles e focus trap

Demonstração

Demonstração da extensão

Instalação

Chrome Web Store (recomendado)

Instale agora na Chrome Web Store — gratuito, sem necessidade de compilação.

Instalação Manual

  1. Clone o repositório:

    git clone https://github.com/joaomjbraga/github-unfollowers.git

  2. Abra chrome://extensions no Chrome

  3. Ative o Modo do Desenvolvedor (canto superior direito)

  4. Clique em Carregar sem compactação e selecione a pasta do projeto

Como Usar

  1. Abra a extensão na barra de ferramentas do Chrome
  2. Crie um token no GitHub com os escopos read:user + user:follow
  3. Cole o token e clique em Conectar
  4. Navegue pelas abas:
Aba Descrição
Não Seguidores Você segue, mas não te seguem de volta
Mútuos Seguidores que também você segue
Não sigo Te seguem, mas você não segue de volta
  1. Use o campo de busca para filtrar por username
  2. Clique em Parar para deixar de seguir ou Seguir para seguir de volta

Atalhos de Teclado

Tecla Ação
1 2 3 Trocar entre abas
/ Focar no campo de busca
H Aba Histórico
W Aba Whitelist
R Aba Listas
T Alternar tema
Esc Fechar painel / modal

Tecnologias

Tecnologia Finalidade
JavaScript (ES Modules) Lógica principal — sem bundler, sem build
Chrome Extensions Manifest V3 Service worker, popup, storage
GitHub REST API Dados de seguidores e seguindo
Chrome Storage API Persistência local de dados

Estrutura do Projeto

github-unfollowers/
├── popup.html              Interface HTML
├── popup.css               Estilos e tema dark/light
├── import.html             Página dedicada de importação (aba separada)
├── manifest.json           Configuração da extensão (MV3)
├── src/
│   ├── main.js             Bootstrap (importa app.js)
│   ├── app.js              Lógica principal, eventos, follow/unfollow
│   ├── api.js              GitHub REST API com retry, rate-limit, ETag cache
│   ├── ui.js               Renderização, histórico, whitelist, virtual scroll
│   ├── background.js       Service worker — detecta mudanças em segundo plano
│   ├── store.js            Estado global compartilhado
│   ├── storage.js          Wrapper tipado para chrome.storage.local
│   ├── cache.js            Cache ETag por página
│   ├── constants.js        Constantes compartilhadas
│   ├── dom.js              Helpers $() e $$()
│   ├── history.js          Histórico de eventos (30 dias)
│   ├── i18n.js             Internacionalização (16 idiomas)
│   ├── import.js           Lógica da página de importação
│   ├── theme.js            Gerenciamento de tema dark/light
│   ├── whitelist.js        Gerenciamento da whitelist
│   ├── utils.js            Funções utilitárias
│   └── dev.js              Mock de cenários de erro (dev)
└── icons/
    ├── icon16.png
    ├── icon48.png
    └── icon128.png

Privacidade

O GitHub Unfollowers não coleta, armazena ou compartilha nenhum dado pessoal. Todos os dados são obtidos diretamente da API oficial do GitHub e processados localmente no seu navegador.

📄 Política de Privacidade

Contribuindo

Contribuições são bem-vindas!

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade (git checkout -b feature/minha-funcionalidade)
  3. Faça commit usando Conventional Commits
  4. Envie para o seu fork (git push origin feature/minha-funcionalidade)
  5. Abra um Pull Request contra o branch main

Licença

Distribuído sob a Licença MIT.

Autor

João M. J. Braga

GitHub LinkedIn