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.
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.
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.