---
title: "Connect a GitHub repository"
description: "Import a repository through the GitHub App, pick it in Codebase Setup, or hand the setup to an engineer who has access."
url: https://help.modeinspect.com/en/articles/11-connect-a-github-repository
collection: "Set up your codebase"
updated: 2026-10-28
language: en
---

# Connect a GitHub repository

Import a repository through the GitHub App, pick it in Codebase Setup, or hand the setup to an engineer who has access.

Connecting a GitHub repository turns it into a codebase you design on. The repository reaches Modeinspect through the Modeinspect GitHub App, which someone installs once on the GitHub account or organization that owns it.

**Before you start**

-   A GitHub account that can see the repository. If you are not an owner of the GitHub organization, skip to **Send the setup to an engineer** below.
    
-   Modeinspect supports React and Next.js styled with Tailwind.
    

## Steps

1.  Click **Add Codebase** in the sidebar. Codebase Setup opens with **Connect a New Codebase**. During onboarding, **Bring your codebase** opens the same page.
    
    ![The Connect a New Codebase card with the GitHub Repository field, the upload area, and the Blank codebase option](https://staticfiles.gleap.io/p6a1872808f187689a3937fa3/j6NloZh54q6TcZgCztZSwjnUbrrCnzIyyRa7WGdlEU2fWuA7vCHcku7WkAsftT6wE8yOQfxXgIj.png)
2.  Click **Import GitHub Repository**. If your organization already imported repositories, click **Import from GitHub** next to **Don't see your repository?** instead.
    
3.  GitHub opens in a popup. Install the Modeinspect app there for the account or organization that owns the repository. When the popup closes, the repository list in Codebase Setup fills in. If GitHub needs an owner's approval that you cannot give, use **Send the setup to an engineer** below instead.
    
4.  Open **Select a repository** and pick yours. Type in **Search repositories…** to filter a long list. The card now shows the repository name with **GitHub repository** under it and a **Change** button.
    
5.  Click **Continue**. Setup starts, and the page shows **Codebase setup** with the repository name. What follows is in [What happens during setup](https://help.modeinspect.com/en/articles/17-what-happens-during-setup.md).
    

## Send the setup to an engineer

When you cannot install the GitHub App yourself, hand the setup to someone who can.

1.  Click **Send to coworker**. The **Hand off the setup to an engineer** dialog opens with a prewritten **Message** that ends with a link.
    
    ![The Hand off the setup to an engineer dialog with the prewritten message, Copy link & message, and Send via Email](https://staticfiles.gleap.io/p6a1872808f187689a3937fa3/RP218wlfPYlvo80DjlZra9zEEgHPwrhNJKGCwZi0ioVKU7iW4CXF2DKqafMSqEOJKaBaxTEdAIy.png)
2.  Edit the message if you want. The link stays in it.
    
3.  Click **Copy link & message** and paste it into your chat, or click **Send via Email**, fill in **Email address**, and click **Send invite**.
    

The link lets your coworker sign up and continue the setup from where you left off. **Send to coworker** also stays on the setup page while setup runs. Use it later when Auto-setup asks for a secret you do not have, see [Answer Auto-setup's questions](https://help.modeinspect.com/en/articles/10-answer-auto-setup-questions.md).

## If it does not work

-   **The repository is not in Select a repository**: the GitHub App has no access to it yet. Click **Import from GitHub** and add the repository to the app's access. A repository that is already a codebase in your organization is not listed either.
    

## Related

-   [What happens during setup](https://help.modeinspect.com/en/articles/17-what-happens-during-setup.md)
    
-   [Upload a codebase as a zip](https://help.modeinspect.com/en/articles/16-upload-a-codebase-as-a-zip.md)
    
-   [Start from a blank codebase](https://help.modeinspect.com/en/articles/15-start-from-a-blank-codebase.md)
    
-   Manage GitHub repositories

## Related

- [Upload a codebase as a zip](https://help.modeinspect.com/en/articles/16-upload-a-codebase-as-a-zip.md)
- [Start from a blank codebase](https://help.modeinspect.com/en/articles/15-start-from-a-blank-codebase.md)
- [What happens during setup](https://help.modeinspect.com/en/articles/17-what-happens-during-setup.md)
- [Answer Auto-setup's questions](https://help.modeinspect.com/en/articles/10-answer-auto-setup-s-questions.md)
- [Review and verify the setup config](https://help.modeinspect.com/en/articles/14-review-and-verify-the-setup-config.md)