GitCity

Cos'è GitCity?

GitCity trasforma la cronologia delle contribuzioni GitHub di un utente in una skyline 3D isometrica interattiva. L'idea centrale è che ogni giorno di contribuzioni pubbliche diventi un “edificio”, con l'attività di commit che influenza l'altezza, permettendo di esplorare l'attività in modo visivo anziché come griglia.

È pensato per utenti GitHub che vogliono presentare i dati di contribuzione in un formato più accattivante—come incorporare un SVG in un README o portfolio di sviluppatori—senza configurazione manuale oltre all'inserimento del nome utente GitHub.

Caratteristiche Principali

• Città 3D isometrica interattiva dalle contribuzioni GitHub: Costruisce una skyline basata sull'attività di contribuzione pubblica per comprendere i pattern a colpo d'occhio.
• Simulazione di guida in città: Include una modalità simulazione per navigare la città “a livello stradale” ed esaminare la skyline in modo spaziale.
• Cambio tema (6 temi): Offre visuali tematiche tra cui Matrix, Noir, Aurora, Ocean, Gold e Ice per adattarsi a diverse preferenze estetiche.
• Filtro temporale per anno, mese o settimana: Permette di limitare la visualizzazione a intervalli temporali specifici invece di mostrare solo la cronologia completa.
• SVG incorporabile per README GitHub e portfolio: Genera un SVG incorporabile per includere la visualizzazione su profili e pagine di progetto di sviluppatori.
• Zero configurazione con nome utente GitHub: Usa il nome utente inserito per recuperare automaticamente i dati di contribuzione pubblica, riducendo i passaggi di setup.

Come Usare GitCity

1. Apri GitCity e inserisci il tuo nome utente GitHub.
2. GitCity recupera i tuoi dati di contribuzione pubblica e rende la città dove i giorni con commit appaiono come edifici.
3. Usa i controlli tema per cambiare l'aspetto e i controlli filtro per concentrarti su un anno, mese o settimana.
4. Per condividerla, usa l'opzione SVG incorporabile per generare un embed per il tuo README GitHub o portfolio di sviluppatori.
5. (Opzionale) Passa alla modalità simulazione e guida attraverso la città per esplorarla a livello stradale.

Casi d'Uso

• Visualizzazione README GitHub personale: Incorpora l'SVG generato in un README per mostrare l'attività di contribuzione come skyline 3D invece di un grafico statico.
• Presentazione portfolio: Includi la visualizzazione della città su una pagina portfolio di sviluppatori per un colpo d'occhio sull'attività di coding.
• Revisione per ambito temporale (mensile o settimanale): Filtra per mese o settimana per rivedere come varia il volume di contribuzioni in periodi brevi.
• Racconto dell'attività con estetiche: Cambia temi (es. Noir o Aurora) quando presenti la skyline in contesti diversi come pagine di progetto o profili social.
• “Passeggiata esplorativa” delle contribuzioni: Usa la modalità simulazione per navigare la città e interpretare visivamente i pattern nella densità di commit.

FAQ

• Quali dati usa GitCity? GitCity recupera i dati di contribuzione pubblica GitHub per il nome utente inserito.

• Come mappa GitCity i commit alla città 3D? Secondo la pagina, ogni giorno con commit diventa un edificio, e più commit, più alta la torre.

• Posso limitare la visualizzazione a un intervallo temporale specifico? Sì. GitCity include filtri per anno, mese o settimana.

• Posso incorporare la visualizzazione su altre pagine? Sì. GitCity offre un SVG incorporabile pensato per README GitHub e portfolio di sviluppatori.

• Devo configurare qualcosa oltre al mio nome utente GitHub? La pagina descrive il setup come zero configurazione oltre all'inserimento del nome utente GitHub.

Alternative

• Visualizzazioni contribuzioni GitHub (heatmap/chart 2D): Invece di una città 3D e simulazione, queste alternative presentano tipicamente le contribuzioni come griglie o grafici; sono più semplici ma meno spaziali.
• Widget statistiche GitHub/portfolio statici: Strumenti che generano badge o riassunti statici possono essere più facili da incorporare, ma di solito non offrono l'esperienza di guida in città o vista 3D con ambito temporale descritta qui.
• Visualizzazione personalizzata da dati API GitHub: Un approccio fai-da-te può produrre visuali su misura (inclusi 3D), ma sposta lo sforzo di setup e manutenzione sull'utente invece di un workflow zero-configurazione.