How provisioning works
Gapstack operates a control plane. That is the only infrastructure we host. We use it to connect your AWS account, manage projects and environments, and run deploys. We do not host the resources that belong to your environments. When you connect an AWS account, CloudFormation creates an IAM role in your account. Gapstack assumes that role and creates a CloudFormation stack for each environment. Those stacks provision APIs, functions, data stores, and the rest of the environment in your AWS account and region. A project only groups environments. It does not create a stack. You own the stacks. You can revoke access from Gapstack or by deleting the connection stack in AWS.Gapstack orchestrates deploys. Environment resources land in your AWS account.
What you can do
Provision on AWS
Create AWS resources from Gapstack. They land in your account, so you own the stack.
Separate environments
Keep environments isolated from each other so you can run development, staging, and production as distinct stacks.
Split accounts and regions
Deploy each environment to its own AWS account, its own region, or both. Gapstack currently supports every AWS region in the United States (
us-*).Deploy from GitHub
Connect your GitHub account and deploy your own application code onto the infrastructure Gapstack provisions.
Monitor AWS cost
Track AWS spend for the accounts and environments you manage in Gapstack.
See your stack
View infrastructure details for the resources Gapstack created, so you know what is running and where.
Get started
Quickstart
Sign up, create an organization, connect AWS and GitHub, and create your first project.
Connect an AWS account
Create the CloudFormation stack and confirm the account shows as Connected in Organization settings.
Supported AWS resources
See the resource types you can provision today. If one is missing, contact us and we add it within two weeks.
Duplicate an environment
Copy resource definitions to a new environment. The first deploy only creates the artifacts bucket and OIDC role.
Workflows
Watch CloudFormation stack events for each deploy without leaving Gapstack.
Webhooks
Set up webhooks on a project or an environment. Gapstack POSTs when those resources change.
Environment variables
Define variables on a project or environment. Environment values override project values and are injected into every Lambda.
View AWS costs
Activate cost allocation tags in AWS, then turn on cost analytics only when you need spend data.
Deploy an artifact to S3
Each environment creates an artifacts bucket and a GitHub OIDC role. Upload without storing AWS keys.
Failed first deploy
If the first deploy of an environment fails, delete the AWS stack and the environment, then recreate it.
Use the API
The API reference is generated from the Gapstack OpenAPI 3 specification.API overview
Base URL, tenant context, and how resources nest.
Authentication
Call the API with a Cognito JWT or a tenant API key.
Interactive playground
Try endpoints in Swagger UI against the production spec.
Changelog
Release notes for the API and product.