Signing in
TracesHub uses GitHub sign-in only — go to app.traceshub.com and authorize with your GitHub account. That’s the entire signup: no separate password, no email verification. Your profile (login, name, avatar, email) is synced from GitHub at sign-in.
On first sign-in, a personal organization is created for you. It behaves like any other org — you’re its owner — and is where repos from your personal GitHub account get imported.
The TracesHub GitHub App
Importing repositories requires the TracesHub GitHub App installed where the repos live — your personal account, a GitHub organization, or both.
To install it, use any of the Connect GitHub buttons in the app (dashboard empty state, Get started guide, Settings → Connected GitHub, or the org switcher’s Connect GitHub org). GitHub walks you through:
- Pick the account or organization to install on.
- Choose repository access — all repositories or only select repositories. TracesHub only ever sees what you grant here; you can change the selection later from GitHub’s settings or via Settings → Connected GitHub → Connect another.
Installing on a GitHub organization creates the matching TracesHub org, and repos you import there become that org’s projects.
What the App is used for
- Listing repositories you can import on the Import a repository page.
- Reading the repo at HEAD of the default branch, which powers the Analytics codebase view and the Files per-line blame view.
- Webhooks — push and installation events keep project state fresh (default branch, latest commit, install/suspend/uninstall lifecycle) without you doing anything.
The App never writes to your repositories.
Managing installations
Settings → Connected GitHub lists every account and organization where the App is installed, along with its repository selection (all or selected). From there you can connect another account or adjust an existing installation.
If an installation is removed or suspended on GitHub’s side, TracesHub learns about it via webhook. Already-imported projects keep their trace data, but views that need repository access (Files, codebase Analytics) will be unavailable until the App is reinstalled.
Next step
With GitHub connected, import a repository as a project.