The simplest way to read and respond to your GitHub notifications on iOS.
What
GitHawk is a small iOS app that makes managing GitHub accounts and projects a little easier. It exists because GitHub’s mobile interface is missing features and is slow.
It is also proof that you can build rather complicated Swift apps with IGListKit.
Why
- Push
IGListKit+ Swift to its limits - Enable project management on mobile
- Explore GitHub’s GraphQL API
- Scratch my Swift-itch
- Create a real, complex app in the open
How
GitHawk will be released with (at least) a three-phased rollout:
- Basic, “read only” version.
- Read notifications for PRs and Issues
- React to comments
- Mark notifications as read
- Add replies to PRs and Issues
- Close, lock, and re-open PRs and Issues
- Label PRs and Issues
- Repo management
- Browse & create Issues
- Browse PRs
- Create & delete labels
- Northstar
- Browse PR content
- Accept, reject, and merge PRs
-
Installation
If you want to build GitHawk locally, run npm install. It will install apollo-codegen that is required to generate the GraphQL models.
Open Source & Copying
I ship GitHawk on the App Store for free and provide its entire source code for free as well. In the spirit of openness, I have licensed my work under MIT so that you can use my code in your app, if you choose.
However, I ask that you please do not ship this app under your own account. Paid or free.
Contributing
If you would like to test the latest changes, you can join the TestFlight by sending your e-mail address to @_ryannystrom in a DM on Twitter.
I’m happy to take PRs, but I’m working off of master at the moment, and your PR might go stale quick. Be warned!
You’ll also need a Client ID and Client Secret.
Once this is released and development slows down I might get more formal about our work. Until then, its the wild, wild west.