Skip to content

Latest commit

 

History

History
115 lines (61 loc) · 4.84 KB

README.md

File metadata and controls

115 lines (61 loc) · 4.84 KB

GitHub Hovercard

Neat hovercards for GitHub.

Installation

Published versions

Manual installation

FAQ

  • Why and how should I bind my access token and which scopes should I allow?

    GitHub limits unauthenticated API requests to 60 per hour but after binding your access token you will be able to enjoy the rate limit of 5,000 requests per hour.

    Triple click on any hovercard and the access token form will pop out.

    You should at lease add permission for public_repo to enable star/unstar, and user:follow to enable follow/unfollow.

  • How can I make the follow/unfollow button work?

    First you need to provide an access token with adequate scopes.

  • Why Chrome warns me the extension might read my browser history?

    It's because GitHub Hovercard uses webNavigation module to dynamically inject content scripts (to support GitHub Enterprise). See #34. GitHub Hovercard won't track or record any of these private data.

  • Why can GitHub Hovercard's demo page find out I have installed the extension or not?

    In Chrome/Opera it's allowed to get this information through the API while in Firefox the extension will add a special attribute (data-github-hovercard) to the page's body element so that the demo page can find out if the user has installed GitHub Hovercard. It's all about user experience and the extension itself won't track or record these data.

  • Why access token doesn't work?

    Now GitHub Hovercard is saving user's private access token into localStorage. localStorage has a limit of 5MB and the problem might be other extensions have consumed too much storage that GitHub Hovercard failed to save access tokens.

Options

For browser extension versions, GitHub Hovercard provide following options:

  • Domain

    Use this option to set custom domains for your GitHub Enterprise service. Note that you don't need to set github.com because it's always included. You may be asked to grant additional permissions for those domains.

  • Theme

    The theme of hovercards. Defaults to GitHub-style hovercards. You can set it back to the classic dark style in the options.

  • Delay

    If you don't want the hovercards to pop up instantly, you may set a delay before they try to retrieve data and appear.

  • Disable Projects

    You can disable hovercards on project pages for less interference.

  • Placement

    You can set the default placement of the hovercards.

  • Readme

    You may disable readme content for repo cards if you don't need it.

  • Show self

    You may choose if you want to show user hovercard for yourself.

Screenshots

Users in trending repo avatars

Users in feeds

Repos in feeds

Issues

Pull requests

Commits

Known issues

For unauthenticated requests, GitHub API has a fairly low request limit.

In later versions I might introduce access tokens to increase this limit.

Working on it.

Authentication is supported from v0.0.7.

Acknowledgements