{"id":13880657,"url":"https://github.com/aws-samples/aws-cdk-stack-builder-tool","last_synced_at":"2025-07-16T17:30:52.186Z","repository":{"id":205279024,"uuid":"713834688","full_name":"aws-samples/aws-cdk-stack-builder-tool","owner":"aws-samples","description":"AWS CDK Builder is a browser-based tool designed to streamline bootstrapping of Infrastructure as Code (IaC) projects using the AWS Cloud Development Kit (CDK). ","archived":false,"fork":false,"pushed_at":"2024-08-01T15:35:30.000Z","size":3104,"stargazers_count":202,"open_issues_count":9,"forks_count":10,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-05T08:18:13.754Z","etag":null,"topics":["cdk","cdk-constructs","cdk-examples","cdk-patterns","cdk-utilities"],"latest_commit_sha":null,"homepage":"https://aws-samples.github.io/aws-cdk-stack-builder-tool/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit-0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aws-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-03T10:33:34.000Z","updated_at":"2025-02-26T15:15:07.000Z","dependencies_parsed_at":"2024-08-01T16:39:56.301Z","dependency_job_id":null,"html_url":"https://github.com/aws-samples/aws-cdk-stack-builder-tool","commit_stats":null,"previous_names":["aws-samples/aws-cdk-stack-builder-tool"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/aws-samples/aws-cdk-stack-builder-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Faws-cdk-stack-builder-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Faws-cdk-stack-builder-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Faws-cdk-stack-builder-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Faws-cdk-stack-builder-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws-samples","download_url":"https://codeload.github.com/aws-samples/aws-cdk-stack-builder-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws-samples%2Faws-cdk-stack-builder-tool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265527543,"owners_count":23782480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cdk","cdk-constructs","cdk-examples","cdk-patterns","cdk-utilities"],"created_at":"2024-08-06T08:03:21.416Z","updated_at":"2025-07-16T17:30:51.248Z","avatar_url":"https://github.com/aws-samples.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# AWS CDK Builder\n[![Release Notes](https://img.shields.io/github/v/release/aws-samples/aws-cdk-stack-builder-tool)](https://github.com/aws-samples/aws-cdk-stack-builder-tool/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**:fire: [Try AWS CDK Builder](https://aws-samples.github.io/aws-cdk-stack-builder-tool/) :fire:**\n\n![sample](assets/aws-cdk-builder.png \"AWS CDK Builder\")\n\n## Table of content\n- [Features](#features)\n- [Deploy](#deploy)\n- [Clean up](#clean-up)\n- [Architecture](#architecture)\n- [Adding private constructs](#adding-private-constructs)\n- [License](#license)\n\n# Features\n\nAWS CDK Builder is a browser-based tool designed to streamline bootstrapping of Infrastructure as Code (IaC) projects using the AWS Cloud Development Kit (CDK). Equipped with a dynamic visual designer and instant TypeScript code generation capabilities, the CDK Builder simplifies the construction and deployment of CDK projects. It stands as a resource for all CDK users, providing a platform to explore a broad array of CDK constructs.\n\n![sample](assets/aws-cdk-builder-code.png \"AWS CDK Builder\")\n![sample](assets/aws-cdk-builder-diagram.png \"AWS CDK Builder\")\n\n# Deploy\n\nYou do not need to deploy the AWS CDK Builder to use it; an online version is available.\n\nhttps://aws-samples.github.io/aws-cdk-stack-builder-tool\n\nBut if you wish to deploy it on your own account, here is a step-by-step guide.\n\n### Environment setup\n\nVerify that your environment satisfies the following prerequisites:\n\nYou have:\n\n1. An [AWS account](https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/)\n2. `AdministratorAccess` policy granted to your AWS account (for production, we recommend restricting access as needed)\n3. Both console and programmatic access\n4. [NodeJS 18](https://nodejs.org/en/download/) installed\n    - If you are using [`nvm`](https://github.com/nvm-sh/nvm) you can run the following before proceeding\n    - ```\n      nvm install 18 \u0026\u0026 nvm use 18\n      ```\n5. [AWS CLI](https://aws.amazon.com/cli/) installed and configured to use with your AWS account\n6. [Typescript 3.8+](https://www.typescriptlang.org/download) installed\n7. [AWS CDK CLI](https://docs.aws.amazon.com/cdk/latest/guide/getting_started.html) installed\n8. [Docker](https://docs.docker.com/get-docker/) installed\n9. [Python 3+](https://www.python.org/downloads/) installed\n\n### Deployment\n\n1. Clone the repository\n```bash\ngit clone https://github.com/aws-samples/aws-cdk-stack-builder-tool\n```\n2. Move into the cloned repository\n```bash\ncd aws-cdk-stack-builder-tool\n```\n\n\u003ca id=\"deployment-dependencies-installation\"\u003e\u003c/a\u003e\n3. Install the project dependencies by running this command\n```bash\nnpm install\n```\n\n4. (Optional) Bootstrap AWS CDK on the target account and region\n\n\u003e **Note**: This is required if you have never used AWS CDK on this account and region combination. ([More information on CDK bootstrapping](https://docs.aws.amazon.com/cdk/latest/guide/cli.html#cli-bootstrap)).\n\n```bash\nnpx cdk bootstrap aws://{targetAccountId}/{targetRegion}\n```\n\nYou can now deploy by running:\n\n```bash\nnpx cdk deploy\n```\n\nYou can view the progress of your CDK deployment in the [CloudFormation console](https://console.aws.amazon.com/cloudformation/home) in the selected region.\n\n5. Once deployed, take note of the `DomainName`\n\n```bash\n...\nOutputs:\ncdk-builder.DomainName = https://dxxxxxxxxxxxxx.cloudfront.net\n...\n```\n\n6. Open the `DomainName` Url for the outputs above, i.e. `https://dxxxxxxxxxxxxx.cloudfront.net`\n\n\n# Clean up\nYou can remove the stacks and all the associated resources created in your AWS account by running the following command:\n\n```bash\nnpx cdk destroy\n```\n\n# Architecture\nAWS CDK Builder is a serverless static website application, created using React and TypeScript.\n\n![sample](assets/architecture.png \"Architecture Diagram\")\n\n# Adding private constructs\nIf there are constructs which are not in the public npm js registry, they can be added as follows:\n\n1. Download the npm package:\n```bash\nnpm pack \u003cyour-package\u003e --pack-destination ./src/react-app/public/constructs\n```\n\n2. Modify a blueprint to use the newly added package. For example, to change the `Blank` blueprint:\n```bash\nopen ./src/react-app/src/blueprints/cdk-blank.ts\n```\n\n3. Modify `libs: {` as follows:\n```typescript\nlibs: {\n  \"@aws-cdk/aws-amplify-alpha\": \"2.x\",\n  ...\n  \"@aws-cdk/region-info\": \"2.x\",\n  \"my-cool-lib-1.2.3.tgz\": \"local\" // \u003c-- This is the line to add, use filename as found in ./src/react-app/src/public/constructs as the key, and \"local\" as the value\n},\n\n```\n\nNow when a project is created using the modified blueprint, it will have access to the private constructs.\n\n# License\n\nThis library is licensed under the MIT-0 License. See the LICENSE file.\n\n- [Changelog](CHANGELOG.md) of the project.\n- [License](LICENSE) of the project.\n- [Code of Conduct](CODE_OF_CONDUCT.md) of the project.\n- [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Faws-cdk-stack-builder-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws-samples%2Faws-cdk-stack-builder-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws-samples%2Faws-cdk-stack-builder-tool/lists"}