GitHub Social

Decentralized social layer · GitHub Social overlays · Browser extension · PWA

Windows / macOS / Linux / Browser JavaScript + Rust Social / Developer Tools
Live Demo Documentation

GitHub Social adds a decentralized, immersive social layer to github.com. The browser extension, PWA, and Tauri desktop app read GitHubSocial.md from any GitHub profile and inject visitor counters, heart reactions, MOTD banners, music autoplay, and comment threads — all styled to look native to GitHub.

Activate any profile in 30 seconds — the app and extension bootstrap the file automatically. No server. No tracking. No account required.

Three ways to use: Tauri desktop app · PWA (no install) · Browser extension

Quick install (PWA)

No install needed — visit frenzypenguin-media.github.io/github-social and add to your home screen.

Features

Feature Description
Immersive overlays Buttons and counters that match github.com’s CSS exactly
GitHubSocial.md Your profile’s social config — theme, music, MOTD, buttons
Journey log Every visit and reaction recorded in your own file
Spoof detection Integrity checker flags tampered profiles
Music autoplay Set a music_url in your MD; visitors hear it on arrival
Anonymous metrics Weekly SVG dashboards show platform trends
Invite flow Detect non-users and send a one-click invite issue

Architecture

GitHubSocial.md (in your profile repo)
        ^
        | read by: extension / PWA / Tauri app
        |
  ┌─────┴──────────────────────────────┐
  │  github.com/{login}/GitHubSocial.md  │
  │  (public, no auth needed to read)     │
  └─────────────────────────────────────┘
        ^
        | two write paths:
        |  1. Your own file (journey log + counters) via gh CLI or REST
        |  2. Other users' files (PR-style reactions, invites)
        |     → opens a GitHub issue on their profile repo
        |     (issue is the reaction; ToS-safe; nothing written silently)