How Can We Help?
Get support for GitStreak and find answers to common questions
Getting Started
Learn how to set up GitStreak and connect your GitHub account
FAQ
Find answers to frequently asked questions
Contact Us
Get in touch with our support team
Getting Started
1. Download and Install
Download GitStreak from the App Store and install it on your iOS device.
Download on the App Store2. Connect Your GitHub Account
To track your contributions, you'll need to connect your GitHub account:
- Open GitStreak and tap "Connect GitHub"
- Generate a personal access token on GitHub (the app will guide you)
- Paste your token into the app
- Your contribution data will sync automatically
3. Set Up Widgets and Notifications
Customize your experience:
- Add widgets to your home screen for quick streak viewing
- Enable daily reminders to maintain your streak
- Customize notification times in Settings
Frequently Asked Questions
How does GitStreak calculate my contribution streak?
GitStreak uses the GitHub API to fetch your contribution data. A contribution is counted when you make commits, open issues, or create pull requests. Your streak continues as long as you have at least one contribution per day.
Is my GitHub token secure?
Yes! Your GitHub token is stored securely in iOS Keychain, which provides hardware-level encryption. The token never leaves your device and is not transmitted to our servers. We only use it to communicate directly with GitHub's API on your behalf.
Why isn't my streak updating?
There could be several reasons:
- GitHub may have a delay in updating contribution data (usually up to 24 hours)
- Your token may have expired - try reconnecting your account
- Check your internet connection
- Pull to refresh in the app to force a sync
Can I track private repository contributions?
Yes! When you generate your personal access token, make sure to grant the 'repo' scope. This allows GitStreak to see your private repository contributions. Your private data remains secure and is never shared.
How do I delete my data?
You can delete all your data from within the app by going to Settings > Privacy > Delete All Data. Alternatively, uninstalling the app will remove all locally stored data. You can also revoke the app's access in your GitHub account settings.
Does GitStreak work offline?
GitStreak caches your contribution data locally, so you can view your streak and statistics offline. However, you'll need an internet connection to sync new data from GitHub and see the latest updates.
Troubleshooting
Widget Not Updating
If your home screen widget isn't updating:
- Ensure Background App Refresh is enabled for GitStreak
- Check that you have a stable internet connection
- Try removing and re-adding the widget
- Open the main app to trigger a manual sync
Authentication Issues
If you're having trouble connecting your GitHub account:
- Verify your personal access token has the correct scopes
- Check if your token has expired
- Ensure you've copied the entire token without spaces
- Try generating a new token on GitHub
Notification Problems
Not receiving notifications?
- Check iOS Settings > Notifications > GitStreak
- Ensure notifications are enabled in the app settings
- Verify Do Not Disturb mode isn't active
- Check if Focus modes are blocking GitStreak
Still Need Help?
Email Support
Get help from our support team. We typically respond within 24-48 hours.
support@thegitstreak.appFeature Requests & Feedback
Have ideas for improving GitStreak? We'd love to hear from you!
Send FeedbackBug Reports
Found a bug? Please report it with as much detail as possible, including your iOS version and steps to reproduce the issue. Send bug reports to bugs@thegitstreak.app