icon-start

Starting with ZenHub

More Than a GitHub Issue Tracker

Using ZenHub for Project Management

ZenHub is not your typical GitHub issue tracker. For one, every feature is crafted specifically for fast-moving software teams. Rather than forcing teams to leave GitHub and jump into another tool (resulting in double work, informational silos, and missed updates), it transforms GitHub into a fully featured project management platform.

Wasted time spent context switching is eliminated. And because everything is fuelled by your GitHub issues and pull requests, you're always working from the most up-to-date data possible. It's the fullest possible integration where you already work.

To use ZenHub, simply download our robust browser extension for Firefox or Chrome. Once you accept the permissions and sign in with GitHub, you'll notice a host of features added right into your GitHub interface.

For the curious types:

ZenHub extension interacts with GitHub in two ways: by fetching metadata from the API – like issue titles, milestones, and PR titles – and then “injecting” project management features into the GitHub interface on the front end. Your code is never touched.

In this guide, we'll show you how to make the most of these features to move faster in GitHub, collaborate more efficiently, and visualize your software projects from beginning to end.

zenhub-features-highlighted

Permissions

Currently, ZenHub permissions are modelled directly after GitHub's. Those with Write access to a repository can edit features (i.e. organizing a task board); those with Read access can only view the features.

ZenHub accounts are based on GitHub organizations, and you can easily control which GitHub organization members have ZenHub licenses. The ZenHub Dashboard is your control center for managing licenses, payments, integrations (like HipChat, Spark, and Slack), and more. For more information on what you can do in the Dashboard, visit our FAQ page.

How ZenHub interacts with GitHub

As outlined in our privacy policy, ZenHub never touches or changes your code. The extension only needs to access certain basic information, like titles of issues and pull requests, so you can organize them in task boards and reports. The only change made visible to non-ZenHub users happens when you create an epic (this action adds an “Epic” GitHub label to the issue).

Next Lesson:
I want to set up my GitHub task boards
You’ll learn…
  • How to master task boards and execute your product backlog