Zenhub unites your team within the GitHub interface with our extensions for Chrome and Firefox, while also integrating team members who need to track, manage and report on projects but are looking to stay focused and may not be too familiar with the GitHub UI through app.zenhub.com.
Using Zenhub Enterprise?
Send us an email with what team you're part of and we'll get you set up with the right URL for your team to access Zenhub on the web and mobile.
Signing in and selecting a workspace
To get started, head to app.zenhub.com and sign in with your email and password, Google Auth0 or GitHub.
Once signed in, you'll be prompted to name the Zenhub Organization you'd like to start with. To access all Zenhub's features, you need to connect with GitHub.
If you aren't using GitHub, you can sign up for an account here.
Can't find your organization listed in the web app? This may be because your GitHub organization hasn't yet granted Zenhub permissions. You can grant third-party access to Zenhub by following the steps outlined here.
Once you've selected the organization you'd like to start in, select the repository or Workspace within that organization you'd like to kick off with. Unsure what repositories are and how they are used in Zenhub? Learn more about repositories, Zenhub, and important agile concepts in our terminology guide here.
If you're just getting started, the best practice is to select the repository where you're taking the majority of your work.
Using Zenhub, you can connect repositories together – even across GitHub organizations – to get a bird's eye view into everything going on across all your team's workspaces. With advanced filters, you can drill down to see only what you need. Learn more here.
Don't yet have any repositories created? Head to github.com and click on the + icon on the top-right corner of any page, then click New Repository.
Once you've selected the repository, you're ready to kick things off on the Board! Learn more about getting started with the Zenhub Board here.
Favoriting a Workspace
If you frequent the same few Workspaces to manage your work, you can favorite a Workspace to have it at the top of the Workspace navigator. Click the star next to the Workspace name on the sidebar to add it to your favorites. Once favorited, it'll be added to the sidebar navigation for easy access:
Navigating the sidebar
Once you're in the product, the sidebar in Zenhub is activated by clicking on the Workspace switcher next to your Workspace name. This will open a list of favorited and recent repositories you've visited within the organization. If you're looking for a repository that isn't listed on this screen, you can use the search bar to bring up that Workspace/repo quickly:
Suppose you belong to more than one organization or need to access a personal repository. In that case, you can click on the name of the current organization you're in or ∨ arrow at the top of the Workspace navigator to toggle between organizations:
Notifications
For every repository, or multi-repo Board in Zenhub, the notifications tab will populate with what you've missed based on the space you're viewing and your personal notification settings.
Notifications are managed on a per-Board basis. If you have a multi-repo Board connected, the notifications for all repositories connected within that workspace will be accessible through the notification tab when viewing any of the connected repositories.
To change your notification settings, head to Manage notifications on the bottom-left of the sidebar, then click on the top-right drop-down to make a change.
