@aws/nx-plugin is a collection of code generators that scaffold full-stack AWS applications inside an Nx monorepo. Every generator produces best-practice application code and the infrastructure to deploy it — type-safe, locally runnable, and deployable from the start, getting you closer to production.
Quick Start
Build with AI
1. Create a workspace
pnpm create @aws/nx-workspace my-project
cd my-project
2. Open your AI assistant in the created workspace and prompt it
"Use the Nx Plugin for AWS to build a full-stack application consisting of a React website with shadcn and Cognito authentication, connected to a TypeScript Strands agent via the AG-UI protocol, and infrastructure to deploy it."
Your AI assistant will use the Nx Plugin for AWS MCP server, which is preconfigured in every workspace you create with the command above, to scaffold, connect, and configure everything. See the Building with AI guide for more details.
Build with the CLI
Create a workspace and start adding components — zero configuration required:
# Create a new workspace
pnpm create @aws/nx-workspace my-project
cd my-project
# Add a tRPC API
pnpm nx g @aws/nx-plugin:ts#api --framework=trpc
# Add a Strands AI agent (Python)
pnpm nx g @aws/nx-plugin:py#agent
# Add a React website
pnpm nx g @aws/nx-plugin:ts#website --framework=react
# Add authentication to your website
pnpm nx g @aws/nx-plugin:ts#website#auth
# Connect your website to your API and agent
pnpm nx g @aws/nx-plugin:connection
# Add CDK infrastructure to deploy it all (or choose Terraform)
pnpm nx g @aws/nx-plugin:ts#infra
See the full Quick Start guide and Dungeon Adventure tutorial for a deeper walkthrough.
Available Generators
| Generator | Description |
|---|---|
init | Configure an existing Nx workspace to use the plugin |
ts#project | TypeScript library |
ts#api | TypeScript API (tRPC or Smithy) with API Gateway + Lambda + Powertools |
ts#rdb | Relational databases with Aurora RDS |
ts#dynamodb | Type-safe DynamoDB single-table design (TypeScript, ElectroDB) |
ts#website | React app (Vite) |
ts#website#auth | Add Cognito auth to a website |
ts#infra | AWS CDK infrastructure project |
ts#lambda-function | TypeScript Lambda with type-safe event sources |
ts#mcp-server | MCP server (TypeScript) |
ts#dcr-proxy | OAuth DCR proxy construct for Cognito-authenticated MCP servers |
ts#agent | Strands Agent (TypeScript) |
ts#agent#guardrails | Amazon Bedrock Guardrail for a TypeScript Agent (experimental) |
ts#nx-generator | Nx generator scaffold |
ts#docs | Documentation site (Astro + Starlight) |
smithy#project | Smithy model project — a service model, or a shape library shared between Smithy projects |
py#project | Python project (uv) |
py#api | Python API (FastAPI) with API Gateway + Lambda + Powertools |
py#rdb | Relational databases with Aurora RDS (Python) |
py#dynamodb | Python DynamoDB project |
py#lambda-function | Python Lambda with type-safe event sources |
py#mcp-server | MCP server (Python) |
py#agent | Strands Agent (Python) |
py#agent#guardrails | Amazon Bedrock Guardrail for a Python Agent (experimental) |
agentcore-gateway | AgentCore Gateway project |
greengrass#component | AWS IoT Greengrass v2 component for Python or TypeScript (experimental) |
agentcore-harness | AgentCore Harness agent loop (experimental) |
connection | Connect projects together (e.g. frontend to API) |
terraform#project | Terraform project |
license | Manage LICENSE files and source headers |
Community
Join us on Slack in the #nx-plugin-for-aws channel to ask questions, share feedback, and connect with other users and contributors.
Contributing
Read our Contributing Guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes.
Code of Conduct
This project has adopted a Code of Conduct that we expect project participants to adhere to. Please read the Code of Conduct so that you can understand what actions will and will not be tolerated.
License
@aws/nx-plugin is Apache 2.0 licensed.