How can we help?

No! gitfocus only needs your GitHub username. We read your public contribution graph (the green squares on your profile) to detect commits. No OAuth, no tokens, no passwords required.

gitfocus uses Apple's Screen Time API to block apps. This is the same secure system that powers Apple's built-in parental controls. We need permission to apply app restrictions on your behalf.

Yes! GitHub counts all commits (public and private) in your contribution graph by default. As long as your contribution settings are set to show "Private contributions," we'll see them.

Go to your GitHub profile → Contribution settings → Check "Private contributions"

Each commit earns you 5 minutes of unlock time. Push 3 commits? That's 15 minutes to scroll Twitter guilt-free. 🎉

Lives are emergency unlocks. When you use a life, all your blocked apps are unlocked until midnight. You start with 1 free life and can earn more through streaks:

• 14-day streak: +1 life
• Then +1 life every month you maintain the streak

Need to finish a quick message but don't have unlock time? You can borrow up to 5 minutes. This creates "debt" that gets paid back from your future commit earnings.

Example: You borrow 3 minutes. Your next commit earns 5 minutes, but 3 go to pay off debt, leaving you with 2 minutes.

The Discipline Bank tracks time you've earned but haven't used. It's a measure of your self-control. Each minute you earn but don't spend on distractions goes into your bank.

Challenge yourself: How many minutes can you bank by the end of the year?

Building a streak unlocks permanent perks:

• 14 days: +1 extra life (then +1/month)
• 30 days: Weekly time bank (unused time resets weekly instead of daily)
• 90 days: Permanent time (earned time never expires)

Here are some things to check:

• Make sure your GitHub username is entered correctly
• Check that your commits show up on your GitHub profile's contribution graph
• If using private repos, ensure "Private contributions" is enabled in GitHub settings
• Wait a few minutes — GitHub's contribution graph can take time to update

Make sure you've:

• Granted Screen Time permissions during setup
• Selected at least one app or category to block
• Started a focus session from the main screen

If issues persist, try going to iOS Settings → Screen Time and ensure gitfocus has the necessary permissions.

Try these steps:

• Force quit and reopen the app
• Restart your device
• Make sure you're on the latest version of gitfocus
• If the issue persists, email us at support@gitfocus.app with details about what happened

To completely reset gitfocus:

• Delete the app from your device
• Reinstall from the App Store
• Go through the onboarding again

Note: Your GitHub username is stored in the Keychain for convenience, so it may be pre-filled when you reinstall.