How stats-organization/github-stats-extended works
GitHub Stats Extended generates customizable GitHub, language, repository, gist, and WakaTime SVG cards. The principal workflow begins with a README image request, passes through the backend router, validates and authorizes parameters, fetches external data, renders a themed card, and returns SVG. The frontend wizard provides a visual configuration path that produces equivalent API URLs. Authentication and request persistence support private access, rate management, and recent-request handling. Unsampled modules are represented only where their paths and documented responsibilities are clear.
Components 30
Backend Gateway
- API Router
apps/backend/router.js - Cache Control
apps/backend/src/common/cache.js - Access Guard
apps/backend/src/common/access.js
Card Generation
- Stats API
packages/core/src/api/index.js - Gist API
packages/core/src/api/gist.ts - Pin API
packages/core/src/api/pin.js - Languages API
packages/core/src/api/top-langs.js - WakaTime API
packages/core/src/api/wakatime.js - Stats Fetcher
packages/core/src/fetchers/stats.ts - Gist Fetcher
packages/core/src/fetchers/gist.ts - Repository Fetcher
packages/core/src/fetchers/repo.ts - Languages Fetcher
packages/core/src/fetchers/top-languages.ts - WakaTime Fetcher
packages/core/src/fetchers/wakatime.ts - Stats Renderer
packages/core/src/cards/stats.ts - Languages Renderer
packages/core/src/cards/top-languages.ts - Repository Renderer
packages/core/src/cards/repo.ts - Gist Renderer
packages/core/src/cards/gist.ts - WakaTime Renderer
packages/core/src/cards/wakatime.ts
Wizard UI
- Card Wizard
apps/frontend/src/wizard/Wizard.tsx - Wizard Home
apps/frontend/src/wizard/Home/Home.tsx - Card URL Builder
apps/frontend/src/wizard/Home/buildCardUrl.ts - Card Display
apps/frontend/src/wizard/Home/stages/Display.tsx
Accounts and Persistence
- Authentication
apps/backend/api-renamed/authenticate.js - User Accounts
apps/backend/src/users.js - Request Database
apps/backend/src/common/database.js
Other components
- README Visitor
- GitHub API
- WakaTime API
- PostgreSQL
- SVG Card
Connections 38
- README Visitor → API Router: requests card
- Card Wizard → Wizard Home: opens wizard
- Wizard Home → Card URL Builder: builds URL
- Card URL Builder → API Router: targets API
- Wizard Home → Card Display: shows preview
- API Router → Access Guard: checks access
- API Router → Cache Control: sets caching
- API Router → Stats API: dispatches stats
- API Router → Gist API: dispatches gist
- API Router → Pin API: dispatches pin
- API Router → Languages API: dispatches languages
- API Router → WakaTime API: dispatches WakaTime
- Stats API → Stats Fetcher: fetches stats
- Stats API → Stats Renderer: renders stats
- Gist API → Gist Fetcher: fetches gist
- Gist API → Gist Renderer: renders gist
- Pin API → Repository Fetcher: fetches repository
- Pin API → Repository Renderer: renders repository
- Languages API → Languages Fetcher: fetches languages
- Languages API → Languages Renderer: renders languages
- WakaTime API → WakaTime Fetcher: fetches time
- WakaTime API → WakaTime Renderer: renders time
- Stats Fetcher → GitHub API: queries GitHub
- Gist Fetcher → GitHub API: queries GitHub
- Repository Fetcher → GitHub API: queries GitHub
- Languages Fetcher → GitHub API: queries GitHub
- WakaTime Fetcher → WakaTime API: queries WakaTime
- Stats Renderer → SVG Card: produces SVG
- Languages Renderer → SVG Card: produces SVG
- Repository Renderer → SVG Card: produces SVG
- Gist Renderer → SVG Card: produces SVG
- WakaTime Renderer → SVG Card: produces SVG
- API Router → Request Database: stores request
- Authentication → User Accounts: authenticates user
- User Accounts → Request Database: stores access
- API Router → Authentication: dispatches auth
- Request Database → PostgreSQL: reads and writes
- Authentication → SVG Card: returns result