# Connecting GitHub

> Linking your GitHub account, importing a repository into a project, and what unlinking does and does not touch.

Source: https://www.revquix.com/docs/projects/connecting-github
Last verified: 2026-09-03

---

**If you want your GitHub repo on Revquix**, connect your account and import it. Connecting GitHub
lets you bring a repository into a project and push your changes back.

## Connecting

Authorise Revquix from the GitHub panel. You are sent to GitHub, you approve, and you come back
connected. The connection belongs to your account, not to one project - connect once and every
project can use it.

## Importing a repository

Pick a repository and a branch, and its files become a project.

> **Warning** - An import is a copy, not a clone
>
> There is no git history in the project, no branches and no remote tracking beyond the link itself.
> You are getting the files at that commit. History stays on GitHub.

Two things to expect on a real repository:

- **Files the project cannot hold are skipped**, and you are told which. The project has a 60-file
  and 256 KiB budget, and most repositories are larger. See [project limits](https://www.revquix.com/docs/projects/project-limits).
- **A file too large to run still imports.** It is stored; it blocks a run until removed. That is
  deliberate - failing an entire import over one generated file nobody meant to execute would be
  worse.

## Choosing what to import

Import a folder rather than a monorepo where you can. A project is a place to work on something
specific, and the limits are sized for that rather than for a whole codebase.

## Unlinking

Unlinking a repository from a project stops the push relationship.

> **Note** - Unlinking touches nothing on GitHub
>
> The repository is untouched - no files removed, no history changed, nothing archived. You have
> disconnected two things, not deleted one of them. The project keeps its files too.

Disconnecting your GitHub account entirely does the same across every project.

- [Pushing to GitHub](https://www.revquix.com/docs/projects/pushing-to-github) - Sending your changes back.

- [Project limits](https://www.revquix.com/docs/projects/project-limits) - Why an import can be partial.