Integrations overview
Simple Hello can pull live data from GitHub, GitLab, and Jira so your flows reflect what's actually happening in your codebase and tracker.
All three integrations follow the same two-step shape:
- Connect at the team level — credentials live on the team, so every project on the team shares one connection.
- Link at the project level — each project picks which specific repos (GitHub) or which Jira project to surface.
This means a team only needs one set of credentials, and individual projects choose what's relevant to them.
Supported integrations
| Integration | Auth | Per-project linking | Read-only? |
|---|---|---|---|
| GitHub | Personal access token (repo scope) | Multiple repos per project | Yes (Phase 1) |
| GitLab | Instance URL + personal access token (read_api). Works with gitlab.com and self-hosted. | Multiple GitLab projects per project | Yes (Phase 1) |
| Jira | Atlassian site URL + email + API token | One Jira project per project | Yes (Phase 1) |
All connections store their tokens AES-encrypted in the database, with
the encryption keys kept out of PocketBase entirely (see
JIRA_TOKEN_ENCRYPTION_KEY, GITHUB_TOKEN_ENCRYPTION_KEY, and
GITLAB_TOKEN_ENCRYPTION_KEY in the env).
Where you set them up
- Team page → Integrations — connect or disconnect a team's GitHub / GitLab / Jira credentials. Owners and admins of the team only.
- Project page → GitHub / GitLab / Jira tab — link repos, GitLab projects, or a Jira project to the current project. Owners and admins of the project only.
Screenshot pending
Team page → Integrations panel with both cards (one connected, one not).
Where the data shows up
Once a project has at least one repo, GitLab project, or Jira project linked, you'll see:
- Project pages (
/projects/[id]/github,/projects/[id]/gitlab,/projects/[id]/jira) — a live board of pull requests, merge requests, GitHub issues, or Jira issues. - Inside the flow editor — individual flow nodes can be linked to a specific GitHub PR, GitHub issue, or Jira issue. The node then shows a small status-coloured badge with the link. (Linking flow nodes to GitLab merge requests is not yet wired up.)
For the per-integration walk-throughs, see: