Support
Answers to the questions that come up most, and a real person at the other end of the email. Write to lokassolutions@gmail.com at any time.
Connecting GitHub
How do I connect my account?
Tap Connect GitHub. It opens GitHub's own sign in and approval screen: no password is typed into Cadence, and there is no code to copy. Approve access, and you're back in Cadence, already syncing.
What can Cadence do with my account?
Read your contribution counts, and nothing else. The scope is
read:user, the narrowest permission that can count private contributions. Nothing can be pushed or edited, and your code is never read.I closed GitHub before approving, or it couldn't reach GitHub.
Nothing was connected and nothing was stored either way. Tap Connect GitHub, or Try again, whenever you like.
What if I reconnect with a different GitHub account?
Cadence replaces the cached history with that account's. Nothing is lost on GitHub either way, and no confirmation is asked: it's a re-read, not a change to anything you own.
How do I revoke access?
On GitHub, under Settings › Applications, revoke Cadence. Your cached history stays readable on the device, and Cadence will tell you access has ended the next time it tries to sync.
What gets counted
Which contributions are included?
The totals come from GitHub's own contribution calendar, so everything GitHub counts is inside every number Cadence shows, private contributions included. Commits, pull requests, issues and reviews can be broken out per day. Discussions and new repositories are in the total only, because GitHub does not report them separately.
Some old commits are not in my grid.
GitHub only counts a commit when it is in a repository that isn't a fork, on the default or gh-pages branch, and made with an email address verified on your account. That rule is GitHub's, and Cadence reads the result rather than recalculating it.
Why did a past year change?
Contribution history is not fixed: it shifts when a private repository becomes public or commits are reattributed. Cadence refetches years rather than treating them as final.
Reading offline
Does it work without a connection?
Yes. Every window, every year and every day reads from the copy cached on the device. Nothing is disabled and nothing is greyed out. A quiet banner names when the app last synced.
When does it sync?
On launch, on pull to refresh, and with Refresh all years in Settings. Nothing happens in the background between those moments: the data is a record of the past, so being a day late costs nothing.
I have no connection and no history yet.
Then there is nothing to show yet. The grid holds its shape and the total shows a dash until the first sync lands. It will fill in by itself once GitHub is reachable.
Your data
Where is my history stored?
On the device only. The GitHub token sits in the iOS keychain or, on Android, an encrypted preferences store the OS restricts to Cadence. There are no Cadence servers and no account, so there is nothing to sign in to and nothing held elsewhere. Depending on your device settings, this data may still be swept into a device backup managed by Apple or Google; that is controlled through your device, not through Cadence.
How do I erase everything?
Two controls in Settings, and they do different things. Disconnect removes the GitHub token only; the cached history stays on the device. Clear everything removes the cached history and the token in one tap. No confirmation is asked, because the cache is derived data: connecting again rebuilds it. Uninstalling the app does the same as Clear everything.
Can I move my history to a new phone?
There is nothing to move. Install Cadence, connect the same GitHub account, and the history is refetched.
Free, and support
Is it free?
Yes. The whole app is free, nothing is paywalled, and there are no ads.
Can I sponsor Cadence?
If you want to, at github.com/sponsors/ivanlokas. It's a donation, not a purchase: it unlocks nothing and changes nothing about the app. GitHub handles the payment; neither the app nor this site ever sees it.
Still stuck? Email lokassolutions@gmail.com. Your device and OS version help; please leave out anything sensitive unless it is needed to solve the problem.