• Stars
    star
    113
  • Rank 310,115 (Top 7 %)
  • Language
    Java
  • License
    Apache License 2.0
  • Created over 9 years ago
  • Updated about 9 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A powerful and simple library to open issues on GitHub directly from your app.

Gitty Reporter

Maven Central
Get it on Google Play

Watch complete video on YouTube.

Is your Inbox full of bug reports and requests from your users?
Gitty Reporter is a new material designed library to report issues from your app directly on GitHub, even without an account.

How to use

Add this to your build.gradle:

repositories {
    mavenCentral()
}

dependencies {
  compile 'com.github.paolorotolo:gitty_reporter:1.2.1'
}

Create a new Activity that extends GittyReporter:

public class Gitty extends GittyReporter {

    // Please DO NOT override onCreate. Use init instead.
    @Override
    public void init(Bundle savedInstanceState) {
        
        // Set where Gitty will send issues.
        // (username, repository name);
        setTargetRepository("paolorotolo", "GittyReporter");
        
        // Set Auth token to open issues if user doesn't have a GitHub account
        // For example, you can register a bot account on GitHub that will open bugs for you. 
        setGuestOAuth2Token("28f479f73db97d912611b27579aad7a76ad2baf5");
        
        
        // OPTIONAL METHODS

        // Set if User can send bugs with his own GitHub account (default: true)
        // If false, Gitty will always use your Auth token
        enableUserGitHubLogin(true);
        
        // Set if Gitty can use your Auth token for users without a GitHub account (default: true)
        // If false, Gitty will redirect non registred users to github.com/join
        enableGuestGitHubLogin(true);
        
        // Include other relevant info in your bug report (like custom variables)
        setExtraInfo("Example string");
        
        // Allow users to edit debug info (default: false)
        canEditDebugInfo(true);
        
        // Customize Gitty appearance
        setFabColor1(int colorNormal, int colorPressed, int colorRipple);
        setFabColor2(int colorNormal, int colorPressed, int colorRipple);
        setBackgroundColor1(int color);
        setBackgroundColor2(int color);
        setRippleColor(int color);
    }
}

Featuring Material Design

Gitty Reporter follows Google's material design guidelines. On >= Lollipop, it also includes material animations watch them in HD.

Example

I've uploaded an example app here on GitHub. Check it out! It's also available on Google Play.

Apps using it

  • Some apps at Numix Project Ltd. We've created a GitHub bot named numix-ood (Doctor Who anyone?).
  • Glucosio.