Skip to content

tysoncung/awesome-cdk-typescript

BranchesTags

Repository files navigation

Awesome CDK TypeScript Awesome

🚀 A curated list of awesome AWS CDK TypeScript resources, libraries, tools, and patterns

AWS CDK Logo TypeScript Logo

Contents • Learning • Constructs • Patterns • Tools • Contributing

Contents

Learning Resources

Official Resources

Tutorials & Workshops

Videos & Courses

Books & Blogs

Construct Libraries

Official AWS Constructs

Community L3 Constructs

High-Level Patterns

Serverless

Containers & Kubernetes

Data & Analytics

Security & Compliance

Patterns & Examples

Application Patterns

Serverless Applications

Web Applications

Infrastructure Patterns

Networking

CI/CD

Multi-Account Patterns

Tools & Utilities

Development Tools

Testing Tools

Validation & Linting

Cost Management

Project Templates

Starter Templates

Organization Templates

TypeScript Specific

Type Safety Patterns

// Type-safe environment configuration
interface EnvironmentConfig {
  account: string;
  region: string;
  vpc: {
    cidr: string;
    maxAzs: number;
  };
}

class TypeSafeStack extends Stack {
  constructor(scope: Construct, id: string, config: EnvironmentConfig) {
    super(scope, id, {
      env: {
        account: config.account,
        region: config.region,
      }
    });
    // Use strongly typed config
  }
}

Generic Constructs

// Reusable generic construct
export class RestApi<T extends Record<string, any>> extends Construct {
  public readonly api: IRestApi;

  constructor(scope: Construct, id: string, props: RestApiProps<T>) {
    super(scope, id);
    // Implementation with type safety
  }
}

Advanced Patterns

TypeScript Configuration

// Recommended tsconfig.json for CDK projects
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "lib": ["ES2020"],
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "declaration": true,
    "declarationMap": true,
    "inlineSourceMap": true,
    "experimentalDecorators": true,
    "strictPropertyInitialization": false,
    "typeRoots": ["./node_modules/@types"]
  },
  "exclude": ["cdk.out", "node_modules"]
}

Real-World Projects

Open Source Applications

Company Case Studies

Best Practices

Project Structure

my-cdk-app/
├── bin/              # CDK app entry points
├── lib/              # Stack definitions
│   ├── constructs/   # Custom constructs
│   ├── stacks/       # Stack classes
│   └── shared/       # Shared utilities
├── test/             # Unit tests
├── scripts/          # Helper scripts
├── config/           # Environment configs
└── docs/             # Documentation

Stack Organization

// Organize stacks by lifecycle and dependencies
export class NetworkStack extends Stack { }
export class DataStack extends Stack { }
export class ComputeStack extends Stack { }
export class MonitoringStack extends Stack { }

Testing Strategy

  • ✅ Unit Tests - Test construct properties
  • ✅ Snapshot Tests - Catch unintended changes
  • ✅ Fine-Grained Assertions - Test specific resources
  • ✅ Integration Tests - Test deployed resources
  • ✅ Compliance Tests - Security and compliance checks

Security Best Practices

  • 🔒 Use least-privilege IAM policies
  • 🔒 Enable encryption at rest and in transit
  • 🔒 Use Secrets Manager for sensitive data
  • 🔒 Enable AWS CloudTrail logging
  • 🔒 Implement resource tagging strategies
  • 🔒 Use CDK Nag for compliance checking

Cost Optimization

  • 💡 Use cost allocation tags
  • 💡 Implement auto-scaling policies
  • 💡 Use Spot instances where appropriate
  • 💡 Set up billing alarms
  • 💡 Regular cost reviews with Infracost

Community & Support

Community Resources

Events & Meetups

Notable Contributors

Migration & Upgrade Guides

Version Migrations

CloudFormation to CDK

Terraform to CDK

Performance & Optimization

Build Performance

Runtime Performance

Cost Optimization Patterns

Troubleshooting & Debugging

Common Issues

Deployment Failures

// Issue: Stack too large (>50MB)
// Solution: Use asset bundling or split into multiple stacks

// Issue: Resource limit exceeded
// Solution: Request service quota increase

// Issue: Circular dependencies
// Solution: Use exportValue() and Fn.importValue()
const vpcId = vpc.exportValue('VpcId');
const importedVpc = ec2.Vpc.fromVpcAttributes(this, 'ImportedVpc', {
  vpcId: Fn.importValue('VpcId')
});

TypeScript Errors

// Issue: Type inference fails
// Solution: Explicit type annotations

const bucket: s3.IBucket = new s3.Bucket(this, 'MyBucket', {
  bucketName: 'my-bucket'
});

// Issue: Module not found
// Solution: Check node_modules and tsconfig paths

Debugging Tools

Log Analysis

// Enable detailed CloudFormation logging
import { CfnOutput } from 'aws-cdk-lib';

new CfnOutput(this, 'StackName', {
  value: this.stackName,
  description: 'Current stack name for debugging'
});

// Enable CDK verbose output
// cdk deploy --verbose
// cdk diff --verbose

Plugins & Extensions

IDE Extensions

CLI Plugins

Build Tool Integrations

Advanced Topics

Multi-Region Deployments

// Deploy to multiple regions
const usEast1App = new App();
new MyStack(usEast1App, 'MyStack-us-east-1', {
  env: { region: 'us-east-1', account: '123456789012' }
});

const euWest1App = new App();
new MyStack(euWest1App, 'MyStack-eu-west-1', {
  env: { region: 'eu-west-1', account: '123456789012' }
});

Custom Resource Providers

import { CustomResource, CustomResourceProvider } from 'aws-cdk-lib';

// Create custom resource for unsupported AWS features
const provider = CustomResourceProvider.getOrCreateProvider(this, 'Custom::MyResource', {
  codeDirectory: './custom-resources',
  runtime: Runtime.NODEJS_18_X,
  policyStatements: [/* IAM permissions */]
});

new CustomResource(this, 'MyCustomResource', {
  serviceToken: provider.serviceToken,
  properties: {
    key: 'value'
  }
});

CDK Aspects

import { IAspect, IConstruct, Tags } from 'aws-cdk-lib';

// Implement cross-cutting concerns
class TaggingAspect implements IAspect {
  visit(node: IConstruct): void {
    if (node instanceof Bucket) {
      Tags.of(node).add('Environment', 'Production');
    }
  }
}

Aspects.of(app).add(new TaggingAspect());

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Criteria for Inclusion

  • Must be TypeScript-specific or have excellent TypeScript support
  • Active maintenance (commits within last 6 months)
  • Clear documentation
  • Adds value to the CDK TypeScript ecosystem
Built with ❤️ by the CDK TypeScript community

About

🚀 A curated list of awesome AWS CDK TypeScript resources, libraries, tools, and patterns

github.com/tyscung/awesome-cdk-typescript

Topics

aws devops awesome cloud typescript serverless infrastructure-as-code awesome-list cdk constructs aws-cdk

Resources

Readme

License

CC0-1.0 license

Contributing

Contributing
Activity

Stars

1 star

Watchers

0 watching

Forks

2 forks
Report repository

Releases 1

🎉 Initial Release: Awesome CDK TypeScript Latest
Sep 18, 2025

Packages

No packages published