$ cat /etc/faq
Frequently Asked Questions
Answers for the most common issues around sign-in, sync, visibility, PRO features, and account management.
Getting Started
What is Git Leaderboard?
Git Leaderboard is a GitHub activity ranking app. It shows aggregated contribution metrics, profile stats, achievements, and optional PRO features such as weekly streak and league competition.
Do I need a GitHub account?
Yes. GitHub sign-in is required to sync your personal data. Without signing in, you can still browse public leaderboard pages.
Why do I need to accept Terms and Privacy before login?
Because the app uses your GitHub token and API rate limit to fetch profile/contribution metrics. Acceptance confirms you understand data usage, security, and visibility rules.
Can I use the app without PRO?
Yes. FREE includes leaderboard, profile stats, achievements, charts, and last 2 years of detailed data. PRO unlocks full history (from 2021), streak, league, and PRO badge. See pricing.
Sync and Data
How often is my data synced?
In normal use, we sync automatically about once every 24 hours. There are a few expected exceptions where sync can happen sooner:
- a new UTC week starts (to keep weekly league context fresh)
- a forced sync is triggered after PRO upgrade
- you manually sync a specific year from your account analytics page
Why is my profile not updated yet?
Possible reasons: data was synced recently (cache hit), GitHub API rate limit pressure, temporary network/API issue, or monthly/yearly data not yet synced for the selected period. Open your account page and run manual sync for the target year.
Why does monthly breakdown sometimes say 'not available'?
Monthly stats appear after the relevant year has been synced with monthly aggregation. If missing, use the sync action on your account page for that year.
Why are older years locked?
FREE plan shows detailed history for the last 2 years. PRO unlocks full history from 2021 onward.
Which metrics are used for ranking and stats?
Main metrics include total contributions, commits, issues, pull requests, PR reviews, merged PRs, repositories created, repositories touched by commits/issues/reviews/PRs, active days, and weighted Impact Score.
What is Impact Score and how is it calculated?
Impact Score is our internal weighted activity metric. It gives higher weight to actions that usually require more review/collab effort:
- commits * 1
- issues * 2
- PR reviews * 3
- merged PRs * 5
Why did my rank change even if my total contributions stayed similar?
Rank depends on selected time scope and selected metric. Changing scope (all-time/year/month) or metric (for example Impact Score vs commits) can reorder positions even with similar totals.
Privacy and Security
Do you read my repository code or file contents?
No. Git Leaderboard does not clone repositories and does not read source code. It only stores aggregated numeric stats returned by GitHub API.
How do private contributions work?
If you enable GitHub's setting "Turning on private contributions will show anonymized private activity on your profile.", those anonymized private totals may be included in your aggregated metrics.
Is my GitHub token stored safely?
Yes. Tokens are encrypted at rest (AES-256-GCM) and used server-side only for API requests. Tokens are not exposed in client responses.
Does the app use my GitHub API rate limit?
Yes. Sync uses your GitHub GraphQL rate-limit budget. Typical usage is around 10-30 points/day per user (depending on plan/usage) out of GitHub's standard 5,000-point hourly limit.
Can I check my remaining GitHub API limit?
Yes. Your account page has a rate-limit check action that fetches live `limit/remaining/used/resetAt` values from GitHub.
Streak and League
Why are streak and league week boundaries different?
Streak is computed in your selected local timezone, while league runs on strict UTC week boundaries (Monday 00:00 to Sunday 23:59 UTC) for fair global competition.
I upgraded to PRO. Why am I still not in league/streak?
After payment, subscription state may take a short moment to confirm via webhook. Once confirmed, a forced sync runs. If needed, refresh your account page after a short wait.
How is league ranking calculated?
League ranking is based on weekly Impact Score, then active days, then weekly contributions as tie-breakers. Promotion/demotion is applied at week finalization.
How does streak threshold work?
A week passes only if you hit required impact threshold and at least 2 active days. Threshold starts low and adapts based on your recent historical activity.
What if I change my timezone?
Timezone changes are deferred to prevent mid-week streak boundary distortion. In practice, the new timezone becomes active at the next week boundary.
Billing and Account
How do I cancel or manage my subscription?
Open the subscription management portal from pricing. You keep PRO access until the current billing period ends.
What happens if payment fails?
Subscription can enter `past_due` while Stripe retries payment. During retry/grace periods, PRO access can remain active depending on current subscription state.
How do I delete my account and data?
Use account deletion from your profile page. This removes your profile, contribution records, streak/league data, and auth records tied to your account.
Where can I read legal details?
See Privacy Policy and Terms of Service.
$ still_need_help? gitleaderboard@gmail.com