GitHub
NextForge connects to GitHub through a GitHub App. Once it's connected you can import repos as projects, keep issues and comments in sync both ways, and hear about pushes and failed builds.
For workspace owners
Connect
Settings → Integrations → Connect GitHub, then pick the GitHub account or organization and the repos to allow. You're sent back to NextForge when it's done.
Import repositories
Import repositories on the same card. Choose a new project per repo, one project for several repos (say web, api and mobile), or an existing project. Open issues come along, up to 500 per repo.
Many repos: organize them into projects
Organize repositories opens a board: repos not in a project on the left, projects as boxes. Suggest projects asks the AI to group related repos (say clinicross-web and clinicross-api into Clinicross) and to match existing projects by name; if the AI is busy it groups by name instead. Drag repos between boxes (or use the arrows on a repo), rename new projects, filter by name, then Apply. Repos already in a project can be moved too: issues already synced stay where they are, new ones go to the new project.
Per project
Project settings → General & Git lists the project's repos. Mark one as the place new issues go, switch issue sync off for a repo, add another repo, or unlink one.
Linking a repo to a project that already has issues doesn't send the old ones, so nothing floods the repo by surprise. To send them, press Send existing issues next to the repo: every issue not on GitHub yet goes over in the background, about one a second (GitHub's limit). Done issues arrive closed, epics get an epic label and test cases a test label. After that they sync both ways like any other.
For everyone: link your account
Settings → Integrations → Your GitHub account → Link. This proves which GitHub user you are, so assignments and comments map to you. Until you link, your GitHub comments show as "@login on GitHub".
What syncs
| Thing | Direction | Notes |
|---|---|---|
| Issue title, description, open/closed, assignees | Both ways | NextForge changes reach GitHub about 2 seconds later. |
| New comments | Both ways | Editing or deleting a comment in NextForge isn't sent to GitHub. |
| Commits, branches, PRs mentioning a key (NF-12) | GitHub → NextForge | Linked on the issue. |
| Push to the default branch | GitHub → NextForge | Inbox and phone notification for project members. |
| Failed Actions run | GitHub → NextForge | Inbox, phone, email and Slack. |
Tables and images inside issue text become plain text when they cross over. Issues deleted in NextForge stay open on GitHub.
For whoever runs the server
The GitHub App is created once and serves every workspace. Its settings, permissions and keys are in Self-hosting → GitHub App.