Prerequisites

To deploy a git project using Stacktape:

1. You must have a Stacktape account. If you don't have an account, please sign up

2. You must have an AWS account connected to your Stacktape organization. Connecting your account takes ~2 minutes. You can connect the account on AWS accounts page in the console

1 - Create new Stacktape project

After signing in to the console, click on Deploy new project and select Git project using console.

Fill in the Project name - this will be the name of your project in Stacktape. A project name must use a small alphanumeric dash case.

1.1 - Connect your Git repository

Option A - GitHub

Click the Connect GitHub Account button to start connecting your GitHub Account/Organization with Stacktape.

Click the Install button to start Stacktape GitHub app configuration.

Select GitHub organization.

Finish installation by clicking the Install button.

Option B - GitLab

Click the Connect GitLab Account button to start connecting your GitLab Account/Project with Stacktape.

Authorize application access to your GitLab account

1.2 - Select repository to deploy

After successfully connecting your git account, go back to project creation in Stacktape console.

Select the repository with the project you wish to deploy.

After you have finished the steps above, continue by clicking the Continue button.

2 - Deploy new stage

After you have created your project, you will be redirected to the project page.

Continue by clicking Create new stage button

2.1 - Configure stage details

Configure your environment details:

1. Branch - branch to use for deployment,
2. Commit - commit to use for initial deployment,
3. Stage - arbitrary alphanumeric dash-case string. For example, production, staging or john-dev.
4. AWS Account - select an AWS account connected to your Stacktape organization.
5. If your repository does NOT contain a stacktape template (stacktape.yml or stacktape.ts), choose Create new infrastructure configuration.

2.2 - Create Stacktape configuration

1. (Recommended) Use the interactive config editor. To learn about how to use it, head over to using the config editor.

2. Use a starter projects with a pre-configured Stacktape configuration.

3. Follow one of the step-by-step tutorials. Currenctly available tutorials are Fullstack Next.js T3 app and Web API.

4. Write the config manually. To make this process easier, you can install Stacktape VScode extension.

2.3 - Deploy

When your template is ready, click on the Deploy now button.

After starting the deployment, you will be redirected to the deployment monitoring page, where you can see the deployment progress.

After deployment succeeds, you can redirect to the stack details page.