How kalyanm45/gitpulse works
GitPulse tracks a configured GitHub account: a manual API sync or scheduled job refreshes its profile, followers, following, repositories, and contributions, then records sync state in MongoDB. The frontend presents audience history, repository analytics, and contribution/dashboard views. The backend call paths are supported by excerpts or the SOURCE INDEX; frontend-to-API wiring and several unsampled UI details are not shown, so those links are omitted.
Main entry points: followers.py Manual sync route · main.py FastAPI app · database.py MongoDB · github_service.py GitHub client
Components 21
Application entry
- FastAPI app
backend/app/main.py - Sync scheduler
backend/app/scheduler.py
Sync and collection
- Follower sync/history
backend/app/services/follower_service.py - Following sync
backend/app/services/following_service.py - Repository analytics
backend/app/services/repo_service.py - Contribution analytics
backend/app/services/contributions_service.py - Profile cache
backend/app/services/profile_service.py - GitHub client
backend/app/services/github_service.py - Sync state
backend/app/services/sync_state.py
Analytics API
- Manual sync route
backend/app/routes/followers.py - Audience routes
backend/app/routes/followers.py - Repository routes
backend/app/routes/repos.py - Contribution routes
backend/app/routes/contributions.py
Persistence
- MongoDB
backend/app/database.py - Database indexes
backend/app/indexes.py
Dashboard UI
- Frontend API client
frontend/src/lib/api.ts - Audience views
frontend/src/app/(app)/audience/page.tsx - Dashboard views
frontend/src/app/(app)/dashboard/page.tsx - Repository views
frontend/src/app/(app)/repositories/page.tsx
Other components
- Account owner
- GitHub REST API
Connections 34
- Account owner → Manual sync route: requests sync
- FastAPI app → Audience routes: mounts routes
backend/app/main.py - FastAPI app → Repository routes: mounts routes
backend/app/main.py - FastAPI app → Contribution routes: mounts routes
backend/app/main.py - FastAPI app → Sync scheduler: starts scheduler
backend/app/main.py - Manual sync route → Profile cache: refreshes profile
backend/app/routes/followers.py - Manual sync route → Follower sync/history: syncs followers
backend/app/routes/followers.py - Manual sync route → Following sync: syncs following
backend/app/routes/followers.py - Manual sync route → Repository analytics: syncs repositories
backend/app/routes/followers.py - Manual sync route → Contribution analytics: syncs contributions
backend/app/routes/followers.py - Manual sync route → Sync state: marks complete
backend/app/routes/followers.py - Audience routes → Follower sync/history: serves audience data
backend/app/routes/followers.py - Audience routes → Following sync: serves following
backend/app/routes/followers.py - Audience routes → Profile cache: serves profile
backend/app/routes/followers.py - Audience routes → Sync state: serves sync status
backend/app/routes/followers.py - Repository routes → Repository analytics: serves repository data
backend/app/routes/repos.py - Contribution routes → Contribution analytics: serves contribution data
backend/app/routes/contributions.py - Follower sync/history → GitHub client: fetches account data
backend/app/services/follower_service.py - Following sync → GitHub client: fetches account data
backend/app/services/following_service.py - Repository analytics → GitHub client: fetches repository data
backend/app/services/repo_service.py - Contribution analytics → GitHub client: fetches contributions
backend/app/services/contributions_service.py - Profile cache → GitHub client: refreshes profile
backend/app/services/profile_service.py - GitHub client → GitHub REST API: calls API
backend/app/services/github_service.py - Follower sync/history → MongoDB: reads and writes
backend/app/services/follower_service.py - Following sync → MongoDB: reads and writes
backend/app/services/following_service.py - Repository analytics → MongoDB: reads and writes
backend/app/services/repo_service.py - Contribution analytics → MongoDB: reads and writes
backend/app/services/contributions_service.py - Profile cache → MongoDB: caches profile
backend/app/services/profile_service.py - Sync state → MongoDB: stores sync time
backend/app/services/sync_state.py - FastAPI app → MongoDB: connects at startup
backend/app/main.py - FastAPI app → Database indexes: ensures indexes
backend/app/main.py - Frontend API client → Audience routes
- Frontend API client → Repository routes
- Frontend API client → Contribution routes