LayeredCraft CDK Constructs

Name: LayeredCraft.Cdk.Constructs
Author: Nick Cipollina

A comprehensive library of reusable AWS CDK constructs for .NET projects, designed for serverless applications and static websites. Built with best practices, observability, and cost efficiency in mind.

Features

🚀 Lambda Functions: Comprehensive Lambda construct with configurable OpenTelemetry support, IAM management, and environment configuration
🌐 Static Sites: Complete static website hosting with S3, CloudFront, SSL certificates, and Route53 DNS management
📊 DynamoDB Tables: Full-featured DynamoDB construct with streams, TTL, and global secondary indexes
🧪 Testing Helpers: Extensive testing utilities with fluent assertions and builders
📝 Type Safety: Full intellisense and compile-time validation
⚡ Performance: Optimized for cold starts with AWS Lambda SnapStart support

Installation

dotnet add package LayeredCraft.Cdk.Constructs

Quick Start

Basic Lambda Function

using Amazon.CDK;
using LayeredCraft.Cdk.Constructs;
using LayeredCraft.Cdk.Constructs.Models;

public class MyStack : Stack
{
    public MyStack(Construct scope, string id, IStackProps props = null) : base(scope, id, props)
    {
        var lambda = new LambdaFunctionConstruct(this, "MyLambda", new LambdaFunctionConstructProps
        {
            FunctionName = "my-api",
            FunctionSuffix = "prod",
            AssetPath = "./lambda-deployment.zip",
            RoleName = "my-api-role",
            PolicyName = "my-api-policy",
            GenerateUrl = true, // Creates Function URL for HTTP access
            IncludeOtelLayer = true, // Enable OpenTelemetry (disabled by default in v2.0+)
            Architecture = "arm64", // Optional: specify architecture (default: amd64)
            EnvironmentVariables = new Dictionary<string, string>
            {
                { "ENVIRONMENT", "production" },
                { "LOG_LEVEL", "info" }
            }
        });
    }
}

Static Website

var website = new StaticSiteConstruct(this, "Website", new StaticSiteConstructProps
{
    DomainName = "example.com",
    SiteSubDomain = "www",
    AssetPath = "./website-build"
});

DynamoDB Table

var table = new DynamoDbTableConstruct(this, "UserTable", new DynamoDbTableConstructProps
{
    TableName = "users",
    PartitionKey = new AttributeDefinition { AttributeName = "userId", AttributeType = AttributeType.STRING },
    GlobalSecondaryIndexes = [
        new GlobalSecondaryIndex
        {
            IndexName = "email-index",
            PartitionKey = new AttributeDefinition { AttributeName = "email", AttributeType = AttributeType.STRING },
            ProjectionType = ProjectionType.ALL
        }
    ]
});

Documentation

📖 Complete Documentation

Lambda Function Construct - Full-featured Lambda functions with OpenTelemetry, IAM, and more
Static Site Construct - Complete static website hosting with CloudFront and SSL
DynamoDB Table Construct - Production-ready DynamoDB tables with streams and indexes
Testing Guide - Comprehensive testing utilities and patterns
Examples - Real-world usage examples and patterns

Requirements

.NET 8.0 or .NET 9.0
AWS CDK v2 (Amazon.CDK.Lib 2.203.1+)
AWS CLI configured with appropriate permissions
Node.js (for CDK deployment)

Contributing

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

Development Setup

# Clone the repository
git clone https://github.com/LayeredCraft/cdk-constructs.git
cd cdk-constructs

# Restore dependencies
dotnet restore

# Build the project
dotnet build

# Run tests
dotnet run --project test/LayeredCraft.Cdk.Constructs.Tests/ --framework net8.0

Code Style

Follow C# coding conventions
Use meaningful names for variables and methods
Add XML documentation for public APIs
Include unit tests for new features
Run tests before submitting PRs

License

This project is licensed under the MIT License.

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: https://layeredcraft.github.io/cdk-constructs/

Changelog

See CHANGELOG.md for details on releases and changes.

Built with ❤️ by the LayeredCraft team

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Taylor Christian}
📖

_{Nick Cipollina}
💻 📖 🚇

This project follows the all-contributors specification. Contributions of any kind welcome!

LayeredCraft CDK Constructs

Features

🚀 Lambda Functions: Comprehensive Lambda construct with configurable OpenTelemetry support, IAM management, and environment configuration
🌐 Static Sites: Complete static website hosting with S3, CloudFront, SSL certificates, and Route53 DNS management
📊 DynamoDB Tables: Full-featured DynamoDB construct with streams, TTL, and global secondary indexes
🧪 Testing Helpers: Extensive testing utilities with fluent assertions and builders
📝 Type Safety: Full intellisense and compile-time validation
⚡ Performance: Optimized for cold starts with AWS Lambda SnapStart support

Installation

dotnet add package LayeredCraft.Cdk.Constructs

Quick Start

Basic Lambda Function

using Amazon.CDK;
using LayeredCraft.Cdk.Constructs;
using LayeredCraft.Cdk.Constructs.Models;

public class MyStack : Stack
{
    public MyStack(Construct scope, string id, IStackProps props = null) : base(scope, id, props)
    {
        var lambda = new LambdaFunctionConstruct(this, "MyLambda", new LambdaFunctionConstructProps
        {
            FunctionName = "my-api",
            FunctionSuffix = "prod",
            AssetPath = "./lambda-deployment.zip",
            RoleName = "my-api-role",
            PolicyName = "my-api-policy",
            GenerateUrl = true, // Creates Function URL for HTTP access
            IncludeOtelLayer = true, // Enable OpenTelemetry (disabled by default in v2.0+)
            Architecture = "arm64", // Optional: specify architecture (default: amd64)
            EnvironmentVariables = new Dictionary<string, string>
            {
                { "ENVIRONMENT", "production" },
                { "LOG_LEVEL", "info" }
            }
        });
    }
}

Static Website

var website = new StaticSiteConstruct(this, "Website", new StaticSiteConstructProps
{
    DomainName = "example.com",
    SiteSubDomain = "www",
    AssetPath = "./website-build"
});

DynamoDB Table

var table = new DynamoDbTableConstruct(this, "UserTable", new DynamoDbTableConstructProps
{
    TableName = "users",
    PartitionKey = new AttributeDefinition { AttributeName = "userId", AttributeType = AttributeType.STRING },
    GlobalSecondaryIndexes = [
        new GlobalSecondaryIndex
        {
            IndexName = "email-index",
            PartitionKey = new AttributeDefinition { AttributeName = "email", AttributeType = AttributeType.STRING },
            ProjectionType = ProjectionType.ALL
        }
    ]
});

Documentation

📖 Complete Documentation

Lambda Function Construct - Full-featured Lambda functions with OpenTelemetry, IAM, and more
Static Site Construct - Complete static website hosting with CloudFront and SSL
DynamoDB Table Construct - Production-ready DynamoDB tables with streams and indexes
Testing Guide - Comprehensive testing utilities and patterns
Examples - Real-world usage examples and patterns

Requirements

.NET 8.0 or .NET 9.0
AWS CDK v2 (Amazon.CDK.Lib 2.203.1+)
AWS CLI configured with appropriate permissions
Node.js (for CDK deployment)

Contributing

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

Development Setup

# Clone the repository
git clone https://github.com/LayeredCraft/cdk-constructs.git
cd cdk-constructs

# Restore dependencies
dotnet restore

# Build the project
dotnet build

# Run tests
dotnet run --project test/LayeredCraft.Cdk.Constructs.Tests/ --framework net8.0

Code Style

Follow C# coding conventions
Use meaningful names for variables and methods
Add XML documentation for public APIs
Include unit tests for new features
Run tests before submitting PRs

License

This project is licensed under the MIT License.

Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: https://layeredcraft.github.io/cdk-constructs/

Changelog

See CHANGELOG.md for details on releases and changes.

Built with ❤️ by the LayeredCraft team

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Taylor Christian}
📖

_{Nick Cipollina}
💻 📖 🚇

This project follows the all-contributors specification. Contributions of any kind welcome!

LayeredCraft/LayeredCraft.Cdk.Constructsv2.1.5.35

Get Started

Readme

LayeredCraft CDK Constructs

Features

Installation

Quick Start

Basic Lambda Function

Static Website

DynamoDB Table

Documentation

Requirements

Contributing

Development Setup

Code Style

License

Support

Changelog

Contributors ✨

LayeredCraft/LayeredCraft.Cdk.Constructsv2.1.5.35

Get Started

Readme

LayeredCraft CDK Constructs

Features

Installation

Quick Start

Basic Lambda Function

Static Website

DynamoDB Table

Documentation

Requirements

Contributing

Development Setup

Code Style

License

Support

Changelog

Contributors ✨