Intro

@aws/nx-plugin is a collection of generators to help you build cloud-native applications with AWS.

Key Features

• Declarative: Generate code that follows best practices for AWS cloud development.
• End-to-end: Generate application code and CDK/Terraform infrastructure to deploy to AWS.
• Component-Based: Add components to your project as needed, from React websites to serverless APIs using either the CLI or UI.
• Learn Once, Use Anywhere: Consistent patterns across different AWS services and application types.
• Open for modification: All code generated is your code and can be edited as you see fit.
• Type safety: Type-safety is employed to support IDE completions and reduce the number of runtime errors encountered.
• Local-first: Iterate quickly by developing locally before deploying to AWS.
• Minimal dependencies: Getting up and running is simple and only requires langugage level global dependencies.

Available Generators

• ts#project - Generate a new TypeScript library.
• ts#infra - Generate a Typescript AWS CDK infrastructure project for your application.
• ts#react-website - Generate a new React based web application using Vite.
• ts#react-website#auth - Add AWS Cognito authentication to your React website.
• ts#trpc-api - Generate a tRPC backend service with Amazon API Gateway/AWS Lambda integrations and AWS Powertools pre-configured.
• ts#nx-generator - Add an Nx Generator to a TypeScript project.
• ts#mcp-server - Add a Model Context Protocol (MCP) server to a TypeScript project.
• ts#strands-agent - Add a Strands Agent to a TypeScript project.
• ts#lambda-function - Generate a TypeScript lambda function with optional type-safe event sources.
• terraform#project - Generate a new Terraform project.
• py#project - Generate a uv based Python project.
• py#fast-api - Generate a FastAPI backend service with AWS Powertools pre-configured.
• py#lambda-function - Add a lambda function to an existing python project with optional type-safe event sources.
• py#mcp-server - Add a Model Context Protocol (MCP) server to a Python project.
• py#strands-agent Add a Strands Agent to a Python project.
• api-connection - Connect frontend applications to backend APIs.
• license - Automatically manage LICENSE files and source code headers in your workspace.

Getting started

@aws/nx-plugin has been designed for gradual adoption from the start, and you can use as little or as much of it as you need.

Follow the Quick Start guide to create a workspace and add projects.

Additional resources

• Build a Dungeon Adventure Game to get an in-depth guided tutorial on how to use the @aws/nx-plugin.
• Add @aws/nx-plugin to your existing project

MCP Server Installation and Setup

This package additionally provides an MCP server to help AI assistants use the Nx Plugin for AWS.

1. Ensure you have node and npm installed (see here)
2. Add the server to your MCP client configuration

Example configuration for Amazon Q CLI MCP (~/.aws/amazonq/mcp.json):

{
  "mcpServers": {
    "aws-nx-mcp": {
      "command": "npx",
      "args": ["-y", "-p", "@aws/nx-plugin", "aws-nx-mcp"]
    }
  }
}

If you have issues such as ENOENT npx, replace the command with /full/path/to/npx (use which npx to find this).

For more details, take a look at the guide here

Contributing

The main purpose of this repository is to continue evolving @aws/nx-plugin, making it faster and easier to use. Development happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements.

Read our Contributing Guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to @aws/nx-plugin.

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.