Registry /
aws / aws-cdk-aws-amplify-alpha
Install & Compatibility
Where this runs
tested against v2.259.0a0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 359.6MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 17.4s · import 0.000s · 360MB
397MB installed
● package 397MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
App
✓ from aws_cdk import App
✗ from aws_cdk import aws_amplify_alpha as amplify
This quickstart demonstrates how to create an AWS Amplify App using the `aws-cdk-aws-amplify-alpha` library. It sets up a GitHub-connected application with a basic build specification. Ensure you have your GitHub OAuth token stored in AWS Secrets Manager and your `GITHUB_OWNER` and `GITHUB_REPO` environment variables set. You will also need to have `aws-cdk-lib` and `aws-cdk.aws-codebuild` installed.
import os
from aws_cdk import (
App, Stack, SecretValue
)
from aws_cdk import aws_amplify_alpha as amplify
from aws_cdk import aws_codebuild as codebuild
class AmplifyStack(Stack):
def __init__(self, scope: App, id: str, **kwargs) -> None:
super().__init__(scope, id, **kwargs)
github_token = SecretValue.secrets_manager("my-github-token") # Store your GitHub token in AWS Secrets Manager
github_owner = os.environ.get('GITHUB_OWNER', 'your-github-username')
github_repo = os.environ.get('GITHUB_REPO', 'your-amplify-repo')
amplify_app = amplify.App(
self, "MyApp",
source_code_provider=amplify.GitHubSourceCodeProvider(
owner=github_owner,
repository=github_repo,
oauth_token=github_token
),
build_spec=codebuild.BuildSpec.from_object_to_yaml({
"version": "1.0",
"frontend": {
"phases": {
"preBuild": {
"commands": ["yarn"]
},
"build": {
"commands": ["yarn build"]
}
},
"artifacts": {
"baseDirectory": "public",
"files": ["**/*"]
}
}
})
)
amplify_app.add_branch("main")
app = App()
AmplifyStack(app, "AmplifyQuickstartStack",
env={'account': os.environ.get('CDK_DEFAULT_ACCOUNT'), 'region': os.environ.get('CDK_DEFAULT_REGION')})
app.synth()
Debug
Known issues
breakingAs an `alpha` module, the APIs are experimental and subject to non-backward compatible changes or removal in any future version, without adhering to Semantic Versioning.fixReview release notes and changelogs (`CHANGELOG.v2.alpha.md` in the AWS CDK GitHub repository) for breaking changes before upgrading. Update your code accordingly.
affects: All alpha versions (2.x.y-alpha.z)
breakingA recent breaking change affects compute role creation when the `platform` property is set to `Platform.WEB_COMPUTE` or `Platform.WEB_DYNAMIC`, leading to the creation of a compute role.fixIf you use `WEB_COMPUTE` or `WEB_DYNAMIC` platforms, be aware that a compute role will now be created. Review IAM policies and ensure appropriate permissions are granted or restricted for this newly created role.
affects: 2.249.0a0 and newer (check changelog for exact version)
gotchaWhen fetching an existing Amplify app using `amplify.App.from_app_id()`, the returned object (`IApp`) provides a read-only reference. You cannot use it to modify the existing Amplify App, such as adding domains or branches directly through this imported reference.fixTo modify an existing Amplify App, you typically need to define it within your CDK stack and then apply changes. If you need to integrate with an existing app for read-only purposes, the `from_app_id` method is appropriate.
affects: All alpha versions
Upgrade
Version history
2.259.0a0latest on PyPI · released Jun 12, 2026
Audit
Dependencies
aws-cdk-librequiredCore AWS CDK library, required for deploying CDK applications.
aws-cdk.aws-codebuildoptionalOften used for defining build specifications for Amplify applications.
aws-cdk.aws-secretsmanageroptionalUsed for securely storing Git OAuth tokens (e.g., GitHub, GitLab).