Deploy the Application

Step 1: Create and Push Your Git Repository

Before deploying, you need to save your application code in a Git repository. Create a new repository on GitHub, initialize Git in your project folder, commit your files, and push them to your repository on GitHub.

Step 2: Navigate to the Creation Page

You can start the project creation flow from two locations in the Web Console:

• From the Home Page: Under "What should autopilot run?", click the Repo card (labeled Connect repo →).
• From the Header: Click the Project Selector dropdown (located in the top left next to the logo) and click Create Project (+) at the bottom of the list.

Step 3: Configure Your Project

Once on the Create Project page:

• Enter a Project Name: Choose a recognizable name for your project (e.g., "Awesome Web App"). This will label your project in the dashboard and track its resources.
• Select Your Repository: A list of repositories available through your installed GitHub App will display under Repository. Select the GitHub repository you created and pushed in Step 1.
  • Missing your repository?
    • If no app is installed: Click the button provided in the warning alert to connect and install the monolayer GitHub App.
    • If the app is installed but your repo isn't listed: Click the "Revise GitHub App permissions" link in the warning alert to grant monolayer access to that specific repository on GitHub.
• Selecting a repository automatically sets the target branch to its default branch (e.g., main).

Step 4: Launch Your Project

Click Create and deploy project at the bottom of the form.

monolayer will register your new project, link it to your GitHub repository, and automatically trigger the initial deployment.

You will be redirected immediately to your new Project Dashboard where you can monitor the deployment progress, track logs, and view your environment configuration.