{"id":42271671,"url":"https://github.com/cdklabs/cdk-appmod-catalog-blueprints","last_synced_at":"2026-03-10T07:08:50.611Z","repository":{"id":317170905,"uuid":"1063203562","full_name":"cdklabs/cdk-appmod-catalog-blueprints","owner":"cdklabs","description":"Library of use case-driven composable CDK solution blueprints to accelerate application development on AWS","archived":false,"fork":false,"pushed_at":"2026-03-03T09:35:50.000Z","size":16025,"stargazers_count":7,"open_issues_count":10,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-03T10:20:35.606Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cdklabs.github.io/cdk-appmod-catalog-blueprints/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cdklabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-24T09:59:30.000Z","updated_at":"2026-03-03T09:35:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"688ca27f-5344-44fe-89e3-69040a5e00f5","html_url":"https://github.com/cdklabs/cdk-appmod-catalog-blueprints","commit_stats":null,"previous_names":["cdklabs/cdk-appmod-catalog-blueprints"],"tags_count":20,"template":false,"template_full_name":"amazon-archives/__template_Apache-2.0","purl":"pkg:github/cdklabs/cdk-appmod-catalog-blueprints","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdklabs%2Fcdk-appmod-catalog-blueprints","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdklabs%2Fcdk-appmod-catalog-blueprints/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdklabs%2Fcdk-appmod-catalog-blueprints/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdklabs%2Fcdk-appmod-catalog-blueprints/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdklabs","download_url":"https://codeload.github.com/cdklabs/cdk-appmod-catalog-blueprints/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdklabs%2Fcdk-appmod-catalog-blueprints/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30280336,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T01:43:35.720Z","status":"online","status_checked_at":"2026-03-09T02:00:08.011Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2026-01-27T07:25:27.440Z","updated_at":"2026-03-10T07:08:50.598Z","avatar_url":"https://github.com/cdklabs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AppMod Catalog Blueprints\n\n\u003e **Build customizable, well-architected applications on AWS in minutes, not months.**\n\n[![GitHub](https://img.shields.io/badge/code-GitHub-green)](https://github.com/cdklabs/cdk-appmod-catalog-blueprints)\n[![Construct Hub](https://img.shields.io/badge/construct--hub-cdklabs-orange)](https://constructs.dev/packages/@cdklabs/cdk-appmod-catalog-blueprints/)\n[![Documentation](https://img.shields.io/badge/docs-cdklabs.github.io-blue)](https://cdklabs.github.io/cdk-appmod-catalog-blueprints/)\n[![npm version](https://img.shields.io/npm/v/@cdklabs/cdk-appmod-catalog-blueprints?label=npm)](https://www.npmjs.com/package/@cdklabs/cdk-appmod-catalog-blueprints)\n[![npm downloads](https://img.shields.io/npm/dt/@cdklabs/cdk-appmod-catalog-blueprints?label=npm%20downloads)](https://www.npmjs.com/package/@cdklabs/cdk-appmod-catalog-blueprints)\n[![PyPI version](https://img.shields.io/pypi/v/appmod-catalog-blueprints?label=pypi)](https://pypi.org/project/appmod-catalog-blueprints/)\n[![PyPI downloads](https://img.shields.io/pepy/dt/appmod-catalog-blueprints?label=pypi%20downloads)](https://pepy.tech/project/appmod-catalog-blueprints)\n[![NuGet version](https://img.shields.io/nuget/v/CdklabsAppmodCatalogBlueprints?label=nuget)](https://www.nuget.org/packages/CdklabsAppmodCatalogBlueprints)\n[![NuGet downloads](https://img.shields.io/nuget/dt/CdklabsAppmodCatalogBlueprints?label=nuget%20downloads)](https://www.nuget.org/packages/CdklabsAppmodCatalogBlueprints)\n[![Maven version](https://img.shields.io/maven-central/v/io.github.cdklabs/appmod-catalog-blueprints?label=maven)](https://central.sonatype.com/artifact/io.github.cdklabs/appmod-catalog-blueprints)\n\nApplication 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](https://aws.amazon.com/cdk/) [L3 constructs](https://docs.aws.amazon.com/cdk/v2/guide/constructs.html), these blueprints accelerate serverless development and modernization with multiple implementation pathways — from ready-to-deploy solutions to fully customizable building blocks.\n\n**Why This Library?**\n- **Use case-driven**: Purpose-built for real business problems — AI workflows, document processing, event-driven architectures, web applications\n- **Multi-layered approach**: Infrastructure Foundation → General Use Cases → Industry Solutions — start with proven patterns, customize as needed\n- **Composable architecture**: Mix and match independent components with standardized interfaces\n- **Enterprise-ready security**: Built-in compliance, encryption, least-privilege IAM, and CDK Nag validation\n- **Multi-language**: TypeScript, Python, Java, .NET via [JSII](https://aws.github.io/jsii/)\n\n---\n\n## MCP Server for AI-Assisted Development\n\nUse the AppMod Catalog Blueprints directly from your AI coding assistant. The [MCP Server](./mcp-appmod-catalog-blueprints/) exposes construct scaffolding, composition, and example discovery via the [Model Context Protocol](https://modelcontextprotocol.io/), so tools like Kiro, Claude Code, and Codex can generate CDK code with the right props, defaults, and dependency wiring.\n\nSee the [MCP Server README](./mcp-appmod-catalog-blueprints/README.md) for setup instructions.\n\n\n## Deploy in 3 Commands\n\n## How to Use This Library\nPick any solution from [the catalog below](#what-you-can-build) and deploy:\n\n```bash\ngit clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git\ncd cdk-appmod-catalog-blueprints/examples/chatbot/customer-service-chatbot  # or any other example\nnpm install \u0026\u0026 npm run deploy\n```\n\n**That's it.** In this example, you now have a well-architected AI chatbot with streaming, authentication, and a React frontend. Swap the path for any other solution — fraud detection, document processing, RAG support, and more.\n\n---\n\n## Two Ways to Use This Library\n\n| Approach | Best For | Get Started |\n|----------|----------|-------------|\n| **🚀 Deploy a Solution** | Quick evaluation, immediate value, proof-of-concepts | Pick from [ready-to-deploy solutions](#what-you-can-build) below — deploy in minutes with sensible defaults |\n| **🔧 Build Custom** | Specific requirements, enterprise integration, tailored applications | Use [individual constructs](#building-blocks) — import into your CDK project, override defaults, inject custom logic |\n\n---\n\n## What You Can Build\n\n### AI Chatbots \u0026 Assistants\n\n| Solution | What It Does | Constructs Used |\n|----------|--------------|-----------------|\n| [**Customer Service Chatbot**](./examples/chatbot/customer-service-chatbot/) | Real-time chatbot with streaming and session management | [InteractiveAgent](./use-cases/framework/agents/), [Frontend](./use-cases/webapp/) |\n| [**Retail Banking Chatbot**](./examples/chatbot/retail-banking-chatbot/) | Banking chatbot with RAG knowledge base and transaction lookup | [InteractiveAgent](./use-cases/framework/agents/), [BedrockKnowledgeBase](./use-cases/framework/agents/knowledge-base/), [Frontend](./use-cases/webapp/) |\n| [**Retail Banking Chatbot (AgentCore)**](./examples/chatbot/retail-banking-chatbot-agentcore/) | High-availability banking bot on AgentCore Runtime | [InteractiveAgent](./use-cases/framework/agents/), [BedrockKnowledgeBase](./use-cases/framework/agents/knowledge-base/) |\n| [**RAG Customer Support**](./examples/rag-customer-support/) | Knowledge-powered Q\u0026A for e-commerce support | [BatchAgent](./use-cases/framework/agents/), [BedrockKnowledgeBase](./use-cases/framework/agents/knowledge-base/) |\n\n### Intelligent Document Processing\n\n| Solution | What It Does | Constructs Used |\n|----------|--------------|-----------------|\n| [**Insurance Claims Portal**](./examples/document-processing/doc-processing-fullstack-webapp/) | End-to-end claims processing with web UI | [AgenticDocumentProcessing](./use-cases/document-processing/), [Frontend](./use-cases/webapp/) |\n| [**Fraud Detection**](./examples/document-processing/fraud-detection/) | AI-powered document fraud analysis with risk scoring | [AgenticDocumentProcessing](./use-cases/document-processing/) |\n| [**Document Summarization**](./examples/document-processing/summarization-pipeline/) | Multi-format summarization with semantic search | [BedrockDocumentProcessing](./use-cases/document-processing/) |\n| [**Agentic Document Processing**](./examples/document-processing/agentic-document-processing/) | Advanced document processing with AI reasoning | [AgenticDocumentProcessing](./use-cases/document-processing/) |\n| [**Bedrock Document Processing**](./examples/document-processing/bedrock-document-processing/) | Document classification and extraction pipeline | [BedrockDocumentProcessing](./use-cases/document-processing/) |\n| [**Minimal Document Processing**](./examples/document-processing/minimal-bedrock-doc-processing/) | Zero-config document processing starter | [BedrockDocumentProcessing](./use-cases/document-processing/) |\n\n---\n\n## Building Blocks\n\nUse individual constructs to build custom applications:\n\n```bash\nnpm install @cdklabs/cdk-appmod-catalog-blueprints\n```\n\n```typescript\nimport { InteractiveAgent } from '@cdklabs/cdk-appmod-catalog-blueprints';\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\n\nnew InteractiveAgent(this, 'MyChatbot', {\n  agentName: 'support-bot',\n  agentDefinition: {\n    bedrockModel: { useCrossRegionInference: true },\n    systemPrompt: new Asset(this, 'Prompt', { path: './prompt.txt' }),\n  },\n});\n```\n\n### Available Constructs\n\n| Construct | What It Does |\n|-----------|--------------|\n| [**InteractiveAgent**](./use-cases/framework/agents/) | Real-time chatbots with SSE streaming, sessions, and auth |\n| [**BatchAgent**](./use-cases/framework/agents/) | Async AI processing for document analysis |\n| [**BaseAgent**](./use-cases/framework/agents/) | Abstract base for custom agent implementations |\n| [**AgenticDocumentProcessing**](./use-cases/document-processing/) | Document workflows with AI agents and tools |\n| [**BedrockDocumentProcessing**](./use-cases/document-processing/) | Document classification and extraction |\n| [**BaseDocumentProcessing**](./use-cases/document-processing/) | Abstract base for custom document processing |\n| [**BedrockKnowledgeBase**](./use-cases/framework/agents/knowledge-base/) | RAG retrieval with access control |\n| [**Frontend**](./use-cases/webapp/) | Static web hosting with CloudFront CDN |\n\n### Foundation \u0026 Utilities\n\n| Component | What It Does |\n|-----------|--------------|\n| [**Network**](./use-cases/framework/foundation/) | VPC with subnets and endpoints |\n| [**Observability**](./use-cases/utilities/) | Logging, tracing, monitoring with Lambda Powertools |\n| [**DataMasking**](./use-cases/utilities/) | PII protection Lambda layer |\n\n---\n\n## Architecture\n\n### How It Works\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                        Your Application                              │\n├─────────────────────────────────────────────────────────────────────┤\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │\n│  │ Interactive │  │   Batch     │  │  Document   │  │   Frontend  │ │\n│  │   Agent     │  │   Agent     │  │ Processing  │  │   (React)   │ │\n│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘ │\n├─────────┼────────────────┼────────────────┼────────────────┼────────┤\n│         │                │                │                │        │\n│  ┌──────▼──────┐  ┌──────▼──────┐  ┌──────▼──────┐  ┌──────▼──────┐ │\n│  │  Bedrock    │  │    Step     │  │   Lambda    │  │ CloudFront  │ │\n│  │  + Cognito  │  │  Functions  │  │   + S3      │  │   + S3      │ │\n│  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘ │\n├─────────────────────────────────────────────────────────────────────┤\n│                    Foundation (Network, Observability)               │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n### Multi-Layered Design\n\nThe library uses a multi-layered architecture that bridges business requirements and technical implementation:\n\n| Layer | What It Is | Purpose |\n|-------|------------|---------|\n| **Infrastructure Foundation** | Abstract base classes (`BaseAgent`, `BaseDocumentProcessing`) | Standardized interfaces and contracts — extend for custom implementations |\n| **General Use Case Implementation** | Concrete classes (`InteractiveAgent`, `BedrockDocumentProcessing`) | Configurable implementations for common patterns — use directly or extend |\n| **Industry-Aligned Solutions** | Deployable examples (`examples/`) | Pre-configured for specific domains (insurance, banking, e-commerce) — deploy as-is or use as reference |\n\n### Composable Architecture\n\nBuild complex systems by combining independent, reusable components:\n\n- **Independent components** with clear interfaces and loose coupling\n- **Mix and match** constructs across different contexts and use cases\n- **Pluggable strategies** for networking, observability, and event handling\n- **Scalable composition** — incremental adoption and gradual modernization\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n```bash\n# Configure AWS credentials\naws configure\n# OR: export AWS_PROFILE=your-profile-name\n\n# Bootstrap CDK (one-time per account/region)\nnpx cdk bootstrap\n```\n\n### Option 1: Deploy a Solution\n\n```bash\ngit clone https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git\ncd cdk-appmod-catalog-blueprints/examples/chatbot/customer-service-chatbot\nnpm install \u0026\u0026 npm run deploy\n```\n\n### Option 2: Use Constructs in Your Project\n\n```bash\nnpm install @cdklabs/cdk-appmod-catalog-blueprints\n```\n\n```typescript\nimport { InteractiveAgent } from '@cdklabs/cdk-appmod-catalog-blueprints';\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\n\nnew InteractiveAgent(this, 'MyChatbot', {\n  agentName: 'my-bot',\n  agentDefinition: {\n    bedrockModel: { useCrossRegionInference: true },\n    systemPrompt: new Asset(this, 'Prompt', { path: './prompt.txt' }),\n  },\n});\n```\n\n---\n\n## Security \u0026 Compliance\n\nAll constructs include enterprise-grade security by default:\n\n| Feature | What You Get |\n|---------|--------------|\n| **CDK Nag Integration** | Automated security compliance checking |\n| **AWS Well-Architected** | Security, reliability, and performance best practices |\n| **Encryption** | KMS at rest, TLS in transit — always on |\n| **IAM** | Least-privilege, resource-scoped permissions |\n| **Compliance Reports** | Generate with `npm test -- --testPathPattern=\"nag.test.ts\"` |\n\n---\n\n## Documentation\n\n- [**Website**](https://cdklabs.github.io/cdk-appmod-catalog-blueprints/) — Full documentation and guides\n- [**Construct Hub**](https://constructs.dev/packages/@cdklabs/cdk-appmod-catalog-blueprints/) — API reference\n- [**Examples**](./examples/) — Complete deployable solutions\n- [**Building Blocks**](./use-cases/) — Individual construct documentation\n\n---\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/CONTRIBUTING.md) for guidelines.\n\n## Disclaimer\n\nThese 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.\n\n## License\n\nApache License 2.0 — see [LICENSE](https://github.com/cdklabs/cdk-appmod-catalog-blueprints/blob/main/LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdklabs%2Fcdk-appmod-catalog-blueprints","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdklabs%2Fcdk-appmod-catalog-blueprints","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdklabs%2Fcdk-appmod-catalog-blueprints/lists"}