Deploy your app in monolayer

Create an empty git repository

First, create an empty repository in your Git provider (GitHub or GitLab). Use the same account that you connected earlier in Git Connections.

You can name it something like:

monolayer-starter

⚠️ Don't add a README or any initial files — we'll do that later.

Create a project in monolayer

Next, go to your monolayer Web Console and click Create Project in the sidebar.

In the dialog:

1. Project Name: enter a descriptive name (e.g., Postgres Starter)
2. Git Repository URL: paste the URL of the empty repository you just created in Git format (for example, git@github.com:your-org/your-app.git).
3. Production Branch: set your main branch (e.g. main)
4. Review & click on Create

Once the project is created, you'll be redirected to its Overview page. You can now link your local codebase to this project.

Set up the application locally

On your local machine in the directory of the monolayer starter app :

Initialize a new Git repository and push your local code to the remote repository you created earlier:

git init
git add .
git commit -m "Initial commit"
git remote add origin <your-repo-url>
git push -u origin main

Watch your first deployment

Within a few seconds, monolayer will automatically detect the push, build your application, and deploy it to your AWS account.

You can monitor progress in the Deployments tab of your project inside the monolayer Web Console.

When the deploy is ready, you'll see a new environment in the sidebar for your project, where you'll find your app environment URL.

🎉 Congratulations!

You've just deployed your first full-stack monolayer app — complete with a managed database, backend, and frontend — all running in your AWS account.

You're now ready to explore monolayer's full capabilities: databases, background tasks, storage, and more — all defined directly in your application code.