---
id: aws-cdk-aws-amplify-alpha
version: "2.265.0a0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-amplify-alpha — The CDK Construct Library for AWS::Amplify

License: permissive · Maintenance: active · Downloads: 197.8K/mo

## What it is and what it does

This package provides CDK constructs for defining AWS Amplify Console applications as infrastructure code. It lets you programmatically set up Git-connected fullstack serverless apps with support for GitHub, GitLab, and CodeCommit repositories, configure multiple branches with environment variables and performance settings, define custom routing rules and single-page application redirects, map custom domains with auto-subdomain registration, and add basic auth and custom response headers.

The package wraps Amplify Console's Git-based workflow into Python classes that integrate with the AWS CDK ecosystem. It depends on aws-cdk-lib for core CDK functionality, constructs for the component model, jsii for language bindings, and publication for metadata handling. The APIs are explicitly marked experimental and subject to breaking changes between releases, so production use requires acceptance of potential upgrade friction.

Use it for:

- Define a fullstack serverless app with GitHub integration, multiple branches (main/dev/staging), and automatic branch preview deployments
- Set up custom domain routing with auto-generated subdomains for feature branches and pull request previews
- Configure single-page application rewrites and custom HTTP response headers for specific URL patterns in a monorepo
- Protect staging or development branches with basic authentication while keeping production public
- Automate branch creation and deletion for feature branches matching a naming pattern

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Defines AWS Amplify hosting infrastructure as code using CDK constructs, enabling Git-based deployment of fullstack serverless web applications with branches, domains, and custom routing rules.

Yes, if you use AWS CDK and need to manage Amplify hosting infrastructure as code. The low install friction and active maintenance are positive. However, accept that the experimental status means breaking changes may occur on upgrades—pin the version and review release notes before updating. Not suitable if you need API stability guarantees.

## Install

pip install aws-cdk-aws-amplify-alpha
uv add aws-cdk-aws-amplify-alpha
poetry add aws-cdk-aws-amplify-alpha

## Installing aws-cdk.aws-amplify-alpha

Before you install: Low install friction with 4 runtime dependencies. Package is actively maintained with a release 1 day old. However, marked as experimental and subject to non-backward compatible changes—breaking updates may require source code modifications when upgrading.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install aws-cdk-aws-amplify-alpha

from aws_cdk import aws_amplify_alpha as amplify
from aws_cdk.aws_secretsmanager import SecretValue

amplify_app = amplify.App(self, "MyApp",
    source_code_provider=amplify.GitHubSourceCodeProvider(
        owner="myorg",
        repository="myrepo",
        oauth_token=SecretValue.secrets_manager("github-token")
    )
)

Requires AWS CDK >= 2.x and Python >= 3.10. Depends on aws-cdk-lib, constructs, jsii, and publication packages.

Verify before relying:

- Stability timeline: when experimental APIs are expected to stabilize or whether breaking changes are frequent
- Performance characteristics under typical branch/domain scaling scenarios
- Compatibility with specific AWS Amplify Console features not covered in the excerpt

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 197.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws amplify cdk constructs, serverless web app deployment, git-based hosting infrastructure, amplify console infrastructure as code, branch management and domain routing, aws-cdk, infrastructure-as-code, experimental-api

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-amplify-alpha) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-amplify-alpha/)