Swift HTML CSS JavaScript Ruby Objective-C
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Add new API key setup info (#1035) Nov 21, 2017
Classes Fix cell size on the Bookmarks tab (#2124) Aug 16, 2018
Design Rewrote the Setup/Getting started page to help contributors get the G… Jul 19, 2018
Freetime.xcodeproj Reactions with ContextMenu (#2112) Aug 14, 2018
Freetime.xcworkspace Merge branch 'master' into feature/1389_pr_branches Apr 8, 2018
FreetimeTests updates/tests detectShortlink method (#1971) Aug 5, 2018
FreetimeWatch Extension Improve Watch app accessibility (#1807) May 19, 2018
FreetimeWatch Improve Watch app accessibility (#1807) May 19, 2018
Local Pods Fixed badge alignment (#2018) Aug 4, 2018
Playgrounds playground for reaction animations Oct 3, 2017
Pods Update MessageViewController (#2104) Aug 13, 2018
Resources Smaller send button and blue (#2035) Aug 5, 2018
Settings.bundle Update MessageViewController (#2104) Aug 13, 2018
docs swap dates (#1626) Mar 8, 2018
fastlane update fastfile appstore step to upload ipa Sep 22, 2017
gql Reactions with ContextMenu (#2112) Aug 14, 2018
tools Remove build number from build phases (#1088) Nov 25, 2017
.gitignore API Keys read from environment variables (#1075) Nov 25, 2017
.swiftlint.yml Thin SwiftLint ruleset (#704) Oct 23, 2017
AppStore.md add app store metadata for contribution (#1373) Jan 9, 2018
Freetime.entitlements Move session management to local pod and add app group (#1636) Mar 11, 2018
Gemfile Update pods and fix build errors (#1494) Feb 5, 2018
Gemfile.lock Update pods and fix build errors (#1494) Feb 5, 2018
LICENSE fixup cleanup Oct 8, 2017
Podfile Migrate Toast component to new Squawk CocoaPod library (#1900) Jul 14, 2018
Podfile.lock Update MessageViewController (#2104) Aug 13, 2018
README.md Update Contributors section with high-pri needs (#2110) Aug 13, 2018
SECURITY.md Security FAQ (#2069) Aug 10, 2018
Setup.md reorder setup page (#2086) Aug 11, 2018
appcenter-post-clone.sh Setup project to build w/ App Center (#1493) Feb 5, 2018
package-lock.json Update Apollo to 0.8.0 and codegen to 0.18.8 (#1656) Mar 17, 2018
package.json Update Apollo to 0.8.0 and codegen to 0.18.8 (#1656) Mar 17, 2018


Build Status

GitHawk is the highest rated iOS app for GitHub.

0️⃣ Inbox Zero your notifications
📝 Comment even faster than on GitHub desktop
👍 The only app with emoji reactions!
⚡️ Native markdown rendering
:octocat: 100% free and open source


We are always looking for contributions from all skill levels! A great way to get started is by helping organize and/or squish bugs.

Highest Priority Needs:

  • 👩‍💼 Product Manager
    • We have some projects and tons of unorganized/unprioritized features. GitHawk needs someone to own the product direction!
  • 👩‍🎨 Designer
    • Like making unique UIs? So do we! We value keeping GitHawk's UX close to core iOS, but, when necessary, create our own high-quality UI components. Helping design for GitHawk is a great opportunity to try new ideas out!
  • 👩‍💻 iOS Project Management
    • There is a lot of low-hanging fruit with our project setup, test and deployment automation, build optimizations, and more! I (@rnystrom) have no idea what I'm doing here. Come point us in the right direction!

If you would like to test the latest changes, join the TestFlight beta by DMing your e-mail address to @_ryannystrom.


If you want to build GitHawk locally, run npm install.

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

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

This will install apollo-codegen that is required to generate the GraphQL models.

See the setup guide for details about API keys and environment variables.

Open Source & Copying

We ship GitHawk on the App Store for free and provide its entire source code for free as well. In the spirit of openness, GitHawk is licensed under MIT so that you can use my code in your app, if you choose.

However, please do not ship this app under your own account. Paid or free.

Why are we building this?

  • Push IGListKit + Swift to its limits
  • Better GitHub project management on mobile
  • Explore GitHub's GraphQL API
  • Scratch my Swift-itch
  • Create a real, complex app in the open