Skip to content
This repository was archived by the owner on Sep 20, 2023. It is now read-only.

GitHawkApp/GitHawk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHawk

BuddyBuild

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:

  1. Basic, "read only" version.
    • Read notifications for PRs and Issues
    • React to comments
    • Mark notifications as read
  2. Add replies to PRs and Issues
    • Close, lock, and re-open PRs and Issues
    • Label PRs and Issues
  3. Repo management
    • Browse & create Issues
    • Browse PRs
    • Create & delete labels
  4. Northstar
    • Browse PR content
    • Accept, reject, and merge PRs
    • 🚀

Installation

To get started, you will need to install node (brew install node), then run these instructions:

git clone https://github.com/rnystrom/GitHawk.git
cd GitHawk
bundle
bundle exec pod install
npm install
open Freetime.xcworkspace/

Next up you will need to set up a Client ID and Client Secret for GitHub.

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

⚠️ This repo is moving fast! ⚠️

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.