GitGrid is the companion app for the GitGrid LED display — a physical 64x32 LED
matrix that shows your GitHub contribution graph in real time.

No accounts. No subscriptions. No cloud services. Just plug in, pair, and go.

HOW IT WORKS
1. Plug in your GitGrid display
2. Open the app and tap your device to pair over Bluetooth
3. Select your WiFi network from the list
4. Enter your GitHub username — the app validates it instantly
5. Tap Save & your contribution grid lights up in seconds

FEATURES
• Guided step-by-step setup — pair, configure WiFi, set your username, done
• Bluetooth Low Energy pairing — no captive portals or serial consoles
• WiFi network scanner — pick your network from a list, no typing SSIDs
• GitHub username validation — confirms your profile exists before sending to the
device, with avatar preview
• Show/hide password toggle for easy WiFi entry
• Device status & diagnostics — see WiFi signal strength, last data refresh, and
error details
• Human-readable error messages with suggested fixes
• Reconfigure anytime — change your WiFi or GitHub username without starting over
• Auto-reconnect — the app remembers your device and reconnects when in range
• Dark mode support

WHAT IS GITGRID?
GitGrid is a physical LED display for developers who want to show off their GitHub
contribution history as a living piece of desk or wall art. The display
auto-refreshes throughout the day so your latest commits always appear. No GitHub
login or token required — just your public username.

The GitGrid display is available at gitgrid.dev

REQUIREMENTS
• A GitGrid LED display (sold separately)
• Bluetooth Low Energy (BLE) capable device
• 2.4GHz WiFi network
• A public GitHub profile