Add a git connector

Before creating your first project, you'll need to set up a Git connection.

This connection lets monolayer link to your Git repositories through AWS CodeConnections.

Note: monolayer never has direct access to your Git repositories. The connection is created and managed entirely by AWS.

---

Open the settings page

In your monolayer Web Console, click Settings in the sidebar. Under the Git Connections section, you'll be able to create a new connection.

Create a git connection

1. Enter a name for your connection
2. Select your Git provider — either GitHub or GitLab
3. Click Create Connection

At this point, your connection will appear in the list with a Pending status.

Complete the connection in AWS

To finalize the setup, click the “Finish create on AWS” link next to your pending connection. This will open the AWS Console on the CodeStar Connections page.

1. Click Update pending connection

2. In the popup window, choose Install a new app

3. Follow the prompts to install the AWS Connector on your GitHub or GitLab account

Once installation is complete, click Connect.

Verify the connection

After connecting, your Git connector should now display a status of Available in the AWS Console.

Return to the monolayer Web Console → Settings page and click Reload. Your connection status should now show as Available.

You're now ready to create your first monolayer Project and connect it to your Git repository.