GitCity

O que é GitCity?

GitCity transforma o histórico de contribuições do GitHub de um usuário em uma cidade 3D isométrica interativa. A ideia central é que cada dia de contribuições públicas se torna um “prédio”, com a atividade de commits influenciando a altura, permitindo explorar sua atividade visualmente em vez de em uma grade.

É destinado a usuários do GitHub que querem apresentar dados de contribuições em um formato mais envolvente — como incorporar um SVG em um README ou portfólio de desenvolvedor — sem configuração manual além de inserir um nome de usuário do GitHub.

Principais Recursos

• Cidade 3D isométrica interativa a partir de contribuições do GitHub: Constrói um skyline baseado na atividade pública de contribuições para que os espectadores entendam padrões de relance.
• Simulação de cidade dirigível: Inclui um modo de simulação onde você pode navegar pela cidade “do nível da rua” para examinar o skyline espacialmente.
• Troca de temas (6 temas): Oferece visuais temáticos incluindo Matrix, Noir, Aurora, Ocean, Gold e Ice para combinar com diferentes preferências estéticas.
• Filtro de tempo por ano, mês ou semana: Permite limitar a visualização a faixas de tempo específicas em vez de mostrar apenas a visão completa do histórico.
• SVG incorporável para README do GitHub e portfólios: Gera um SVG incorporável para que a visualização possa ser incluída em perfis de desenvolvedores e páginas de projetos.
• Configuração zero via nome de usuário do GitHub: Usa o nome de usuário inserido para buscar dados de contribuições públicas automaticamente, reduzindo etapas de configuração.

Como Usar o GitCity

1. Abra o GitCity e insira seu nome de usuário do GitHub.
2. GitCity busca seus dados de contribuições públicas e renderiza a cidade onde dias com commits aparecem como prédios.
3. Use os controles de tema para alterar a aparência e os controles de filtro para focar em um ano, mês ou semana.
4. Se quiser compartilhar, use a opção de SVG incorporável para gerar um embed para seu README do GitHub ou portfólio de desenvolvedor.
5. (Opcional) Mude para o modo de simulação e dirija pela cidade para explorá-la do nível da rua.

Casos de Uso

• Visualização no README pessoal do GitHub: Incorpore o SVG gerado em um README para mostrar atividade de contribuições como um skyline 3D em vez de um gráfico estático.
• Apresentação em portfólio: Inclua a visualização da cidade em uma página de portfólio de desenvolvedor para oferecer uma visão geral da atividade de codificação.
• Revisão por escopo de tempo (mensal ou semanal): Filtre por mês ou semana para revisar como o volume de contribuições muda em períodos mais curtos.
• Narrativa de atividade por estética: Mude temas (ex.: Noir ou Aurora) ao apresentar seu skyline em contextos diferentes como páginas de projetos ou perfis sociais.
• “Passeio” exploratório pelas contribuições: Use o modo de simulação para navegar pela cidade e interpretar visualmente padrões na densidade de commits.

Perguntas Frequentes

• Quais dados o GitCity usa? GitCity busca dados de contribuições públicas do GitHub para o nome de usuário que você inserir.

• Como o GitCity mapeia commits para a cidade 3D? De acordo com a página, cada dia com commits se torna um prédio, e mais commits, mais alta a torre.

• Posso limitar a visualização a um intervalo de tempo específico? Sim. GitCity inclui filtros para ano, mês ou semana.

• Posso incorporar a visualização em outras páginas? Sim. GitCity oferece um SVG incorporável destinado a READMEs do GitHub e portfólios de desenvolvedores.

• Preciso configurar algo além do meu nome de usuário do GitHub? A página descreve a configuração como zero configuração além de inserir um nome de usuário do GitHub.

Alternativas

• Visualizações de contribuições do GitHub (mapas de calor 2D/gráficos): Em vez de uma cidade 3D e simulação, essas alternativas geralmente apresentam contribuições como grades ou gráficos; são mais simples, mas menos espaciais.
• Widgets de estatísticas GitHub para portfólio/estáticas: Ferramentas que geram badges ou resumos estáticos podem ser mais fáceis de incorporar, mas geralmente não oferecem a experiência de dirigir pela cidade ou visualização 3D com escopo de tempo descrita aqui.
• Visualização personalizada construída a partir de dados da API do GitHub: Uma abordagem DIY pode produzir visuais personalizados (incluindo 3D), mas transfere o esforço de configuração e manutenção para o usuário em vez de usar um fluxo de trabalho de configuração zero.