How to Create a Project from a GitHub Repository

This guide walks you through connecting your GitHub repository to monolayer and initiating your first project deployment.

---

Creating a Project

To connect your GitHub repository and trigger an initial deployment, you can use the project creation form in the control plance.

Steps

1. Navigate to the Create Project page using one of the following pathways:
   • From the Home Page: Click the Repo card.
   • From the Header: Choose Create Project (+) from the Project Selector pop-up menu.
2. Type a name for your project in the Project Name field. Choose a recognizable name (such as Awesome Web App) to identify your project and its resources.
3. Select your repository from the Repository pop-up menu. Choose the GitHub repository you created and pushed in Step 1.
   • When you select a repository, the system automatically sets the target branch to its default branch (such as main).
   • If the monolayer GitHub App is not installed, click the button in the warning alert to install the app.
   • If the app is installed but your repository is not listed, click the Revise GitHub App permissions link in the warning alert to grant access.
4. Click Create and deploy project at the bottom of the form.

Expected Result

The control plane registers your project, links it to your repository, and starts the initial deployment.