GitConnect Docs

Getting Started

Welcome to GitConnect. This application is designed to help you analyze, audit, and clean up your GitHub connections. By connecting your GitHub account, you can quickly find out who is not following you back and prune your following list.

Connection Flow

  1. Click Continue with GitHub on the home screen.
  2. Authorize the GitConnect application on GitHub (requires read:user and user:follow OAuth scopes).
  3. Once authorized, you will be redirected to the secure dashboard to view your network data.

Ghost Finder

A Ghost Connection (or one-way follow) occurs when you follow a developer, but they do not follow you back. This section displays a paginated list of all accounts you follow that haven't returned the connection.

We query both lists in real time using secure, rate-limit optimized pages, cache the results for 60 seconds to respect GitHub API boundaries, and perform a cross-reference join in memory.

Clean Pruning

Pruning helps keep your social feed clean and focused on developers you interact with.

How to Unfollow Ghosts

Navigate to the Not Following Back card in your dashboard. Click the Unfollow button next to any username. This fires a secure DELETE call to the GitHub follow API on your behalf. The UI will animate, showing an active loader, and notify you of success via a toast alert.

3D Glitch Canvas

The visual background on the login screen is a custom 3D particle nodes network built using HTML5 Canvas and vanilla Javascript. It features:

  • Inertia-based Mouse Tracking: The 3D coordinates rotate based on cursor position. Leaving the panel triggers a slow, default orbital drift.
  • Dynamic HSL parsing: Uses MutationObservers to match the system theme color variables, serving dark lines in Light Mode and light lines in Dark Mode automatically.
  • Scanline Glitches: Flickers the pixel nodes occasionally to create an industrial, studio cyberpunk aesthetic (inspired by Linkin Park album visuals).

FAQ & Troubleshooting

Is my GitHub token safe?

Yes. Your Access Token is stored securely inside the session cookies encrypted by NextAuth and is only passed directly to the GitHub API over secure HTTPS connections. We never save your token to any external database.

Why are some avatars slow to load?

Avatars are served directly from the GitHub content delivery network. During periods of high traffic, upstream image responses may occasionally lag.