AppMod Catalog Blueprints

Build customizable, well-architected applications on AWS in minutes, not months.

Application Modernization (AppMod) Catalog Blueprints is a comprehensive library of use case-driven infrastructure blueprints and industry-aligned solutions built on AWS Well-Architected best practices. Designed as composable, multi-layered AWS CDK L3 constructs, these blueprints accelerate serverless development and modernization with multiple implementation pathways — from ready-to-deploy solutions to fully customizable building blocks.

Why This Library?

• Use case-driven: Purpose-built for real business problems — AI workflows, document processing, event-driven architectures, web applications
• Multi-layered approach: Infrastructure Foundation → General Use Cases → Industry Solutions — start with proven patterns, customize as needed
• Composable architecture: Mix and match independent components with standardized interfaces
• Enterprise-ready security: Built-in compliance, encryption, least-privilege IAM, and CDK Nag validation
• Multi-language: TypeScript, Python, Java, .NET via JSII

How to Use This Library

Refer to Getting Started for more details.

What You Can Build

AI Chatbots & Assistants

Intelligent Document Processing

Data Generation

Building Blocks

Use individual constructs to build custom applications:

npm install @cdklabs/cdk-appmod-catalog-blueprints

import { InteractiveAgent } from '@cdklabs/cdk-appmod-catalog-blueprints';
import { Asset } from 'aws-cdk-lib/aws-s3-assets';

new InteractiveAgent(this, 'MyChatbot', {
  agentName: 'support-bot',
  agentDefinition: {
    bedrockModel: { useCrossRegionInference: true },
    systemPrompt: new Asset(this, 'Prompt', { path: './prompt.txt' }),
  },
});

Available Constructs

Foundation & Utilities

Architecture

How It Works

┌─────────────────────────────────────────────────────────────────────┐
│                        Your Application                              │
├─────────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │
│  │ Interactive │  │   Batch     │  │  Document   │  │   Frontend  │ │
│  │   Agent     │  │   Agent     │  │ Processing  │  │   (React)   │ │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘ │
├─────────┼────────────────┼────────────────┼────────────────┼────────┤
│         │                │                │                │        │
│  ┌──────▼──────┐  ┌──────▼──────┐  ┌──────▼──────┐  ┌──────▼──────┐ │
│  │  Bedrock    │  │    Step     │  │   Lambda    │  │ CloudFront  │ │
│  │  + Cognito  │  │  Functions  │  │   + S3      │  │   + S3      │ │
│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘ │
├─────────────────────────────────────────────────────────────────────┤
│                    Foundation (Network, Observability)               │
└─────────────────────────────────────────────────────────────────────┘

Multi-Layered Design

Composable Architecture

Build complex systems by combining independent, reusable components:

• Independent components with clear interfaces and loose coupling
• Mix and match constructs across different contexts and use cases
• Pluggable strategies for networking, observability, and event handling
• Scalable composition — incremental adoption and gradual modernization

Getting Started

Prerequisites

# Configure AWS credentials
aws configure
# OR: export AWS_PROFILE=your-profile-name

# Bootstrap CDK (one-time per account/region)
npx cdk bootstrap

Deploy a Solution

Clone the repo, pick an example from the catalog, and deploy:

git clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git
cd cdk-appmod-catalog-blueprints/examples/chatbot/customer-service-chatbot
npm install && npm run deploy

That's it — you now have a well-architected AI chatbot with streaming, authentication, and a React frontend. Swap the path for any other solution.

Build Custom

Import constructs into your own CDK project:

npm install @cdklabs/cdk-appmod-catalog-blueprints

import { InteractiveAgent } from '@cdklabs/cdk-appmod-catalog-blueprints';
import { Asset } from 'aws-cdk-lib/aws-s3-assets';

new InteractiveAgent(this, 'MyChatbot', {
  agentName: 'my-bot',
  agentDefinition: {
    bedrockModel: { useCrossRegionInference: true },
    systemPrompt: new Asset(this, 'Prompt', { path: './prompt.txt' }),
  },
});

Override defaults, extend base classes, and inject custom logic as needed. See Building Blocks for available constructs.

AI-Assisted

Use AI coding assistants to scaffold and compose constructs with correct props and dependency wiring. The MCP Server exposes tools for genAI coding agents (Kiro, Claude Code, Codex etc.) via the Model Context Protocol.

See the MCP Server README for setup, or install the appmod-blueprints-builder skill for guided workflows.

Security & Compliance

All constructs include enterprise-grade security by default:

Documentation

• Website — Full documentation and guides
• Construct Hub — API reference
• Examples — Complete deployable solutions
• Building Blocks — Individual construct documentation
• MCP Server — AI-assisted development tools
• Agent Skills — AI assistant skills

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Disclaimer

These solutions are examples to help you build applications, not supported products. Any applications you build should be thoroughly tested, secured, and optimized according to your security standards before production use.

License

Apache License 2.0 — see LICENSE for details.