aws-amplify

AWS Amplify Claude Plugin

Build full-stack applications with AWS Amplify Gen 2 using TypeScript code-first development.

Overview

This plugin provides a workflow orchestrator for AWS Amplify Gen 2 development. It validates prerequisites, analyzes project state, retrieves official AWS SOPs via MCP, and guides you through backend creation, deployment, and frontend integration.

Features

• SOP-Driven: Uses official AWS Amplify Standard Operating Procedures via MCP
• Phased Workflow: Backend → Sandbox → Frontend → Testing → Production
• Framework Support: React, Next.js, Vue, Angular, React Native, Flutter, Swift, Android
• Gen 2 Only: TypeScript code-first (defineAuth, defineData, defineStorage, defineFunction)

Prerequisites

• Node.js 18.x or later
• AWS credentials configured (aws configure or aws sso login)
• Claude Code 1.0.33 or later
• uv package manager for MCP server: https://docs.astral.sh/uv/getting-started/installation/

Installation

Option 1: Load locally (recommended for testing)

git clone https://github.com/hfurkanbozkurt/aws-amplify-claude-plugin
claude --plugin-dir ./aws-amplify-claude-plugin

Option 2: Copy to your project

Copy the plugin directory into your project and load it:

claude --plugin-dir ./aws-amplify-claude-plugin

Option 3: Multiple plugins

You can load multiple plugins at once:

claude --plugin-dir ./aws-amplify-claude-plugin --plugin-dir ./another-plugin

Usage

Slash Command

/aws-amplify:build I want to create a todo app with authentication

Auto-Invoked Skill

The amplify-workflow skill is automatically invoked when you mention Amplify-related topics:

• "Amplify", "backend", "sandbox", "deploy"
• Adding auth, data, storage, functions
• Building full-stack apps

Just describe what you want naturally.

Workflow Phases

Phase	Description	SOP
Backend	Create/modify Amplify resources	amplify-backend-implementation
Sandbox	Deploy to sandbox for testing	amplify-deployment-guide
Frontend	Connect frontend to backend	amplify-frontend-integration
Testing	Local verification	Manual
Production	Deploy to production	amplify-deployment-guide

Common Patterns:

• New app: Backend → Sandbox → Frontend → Testing → Production
• Add feature: Backend → Sandbox
• Redeploy: Sandbox only
• Connect UI: Frontend → Testing
• Go live: Production only

Plugin Structure

aws-amplify-claude-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── commands/
│   └── build.md             # /aws-amplify:build command
├── skills/
│   └── amplify-workflow/
│       └── SKILL.md         # Auto-invoked orchestrator
├── .mcp.json                # AWS MCP server config
├── .gitignore
├── package.json
├── LICENSE
└── README.md

AWS Credentials

Must be configured before use:

# Option 1: Access keys
aws configure

# Option 2: SSO
aws sso login

# Verify
aws sts get-caller-identity

MCP Server

This plugin requires the AWS MCP server for SOP retrieval. It's automatically configured via .mcp.json.

Verify it's working:

/mcp

Should show aws-mcp as active.

If MCP is unavailable, the plugin will STOP and ask you to configure it. It will not proceed without MCP.

License

Apache-2.0

Resources

• AWS Amplify Docs
• Amplify Gen 2 Guide
• Claude Code Plugins
• Model Context Protocol