# Connect a repository

Starlings reads GitHub through its own App, installed on the `envisioning` org. To set up the App itself, see docs/GITHUB_CONNECTOR.md.

1. Open `/admin/connectors/github`: Admin → Connectors → the GitHub card. Only an org admin can make changes.
2. Find the repository. Map it to the project.
3. Press **Sync now**. The row shows `Synced · n pulls`.
4. Open the project in Work. Issues and pull requests are on the Issues pane; **New Issue** creates an issue through the App.

Any member can also link a repository from Work, on the Mac or iPhone: **Edit details** on the project, then **Repository**, or **Link GitHub repository…** on the project's context menu. This link writes the same mapping. Starlings refuses a repository that is already linked to another subject.

A project shows the Issues pane only once a repository is linked.

To unmap, reverse the mapping on the same row.