MCPcopy
hub / github.com/aws-amplify/amplify-cli

github.com/aws-amplify/amplify-cli @v14.5.1 sqlite

repository ↗ · DeepWiki ↗ · release v14.5.1 ↗
8,280 symbols 32,989 edges 2,756 files 768 documented · 9%
README

AWS Amplify

Discord Chat

Reporting Bugs/Feature Requests

Open Bugs Feature Requests Closed Issues

[!Important]

Amplify Gen 2 is now generally available

If you are starting a new project, we recommend starting with Amplify Gen 2.

If you are an existing Gen 1 customer, we encourage you to start migrating to Gen 2 using the migration guide and tooling.

⚠️ Amplify Gen 1 is in Maintenance Mode

Amplify Gen1 is in maintenance mode. Starting May 1, 2026, Gen 1 backends will receive only critical bug fixes and security patches and will reach end of life on May 1, 2027. Migrate your backend to Amplify Gen 2 using the migration guide and tooling to continue receiving new features and support.


AWS Amplify CLI (Gen 1)

The AWS Amplify CLI is a toolchain which includes a robust feature set for simplifying mobile and web application development. The CLI uses AWS CloudFormation and nested stacks to allow you to add or modify configurations locally before you push them for execution in your account.

Install the CLI

  • Requires Node.js® version 22 or later

Install and configure the Amplify CLI as follows:

$ npm install -g @aws-amplify/cli
$ amplify configure

Commands Summary

The Amplify CLI supports the commands shown in the following table.

Command Description
amplify configure Configures the AWS access credentials, AWS Region and sets up a new AWS User Profile
amplify init Initializes a new project, sets up deployment resources in the cloud and prepares your project for Amplify.
amplify configure project Updates configuration settings used to setup the project during the init step.
amplify add <category> Adds cloud features to your app.
amplify update <category> Updates existing cloud features in your app.
amplify push [--no-gql-override] Provisions cloud resources with the latest local developments. The 'no-gql-override' flag does not automatically compile your annotated GraphQL schema and will override your local AppSync resolvers and templates.
amplify pull Fetch upstream backend environment definition changes from the cloud and updates the local environment to match that definition.
amplify publish Runs amplify push, publishes a static assets to Amazon S3 and Amazon CloudFront (*hosting category is required).
amplify status [ <category>...] Displays the state of local resources that haven't been pushed to the cloud (Create/Update/Delete).
amplify status -v [ <category>...] Verbose mode - Shows the detailed verbose diff between local and deployed resources, including cloudformation-diff
amplify serve Runs amplify push, and then executes the project's start command to test run the client-side application.
amplify delete Deletes resources tied to the project.
amplify help | amplify <category> help Displays help for the core CLI.
amplify codegen add | generate Performs generation of strongly typed objects using a GraphQL schema.
amplify env add | list | remove | get | pull | import | checkout See the multienv docs.

Category specific commands:

Tutorials

Developing

To set up your local development environment, go to Local Environment Setup.

To test your category, do the following:

cd <your-test-front-end-project>
amplify-dev init
amplify-dev <your-category> <subcommand>

Before pushing code or sending a pull request, do the following:

  • At the command line, run yarn lint at the top-level directory. This invokes eslint to check for lint errors in all of our packages.
  • You can use yarn lint to find some of the lint errors. To attempt fix them, go to the package that has errors and run yarn lint-fix
  • If there are any remaining lint errors, resolve them manually. Linting your code is a best practice that ensures good code quality so it's important that you don't skip this step.

Contributing

We are thankful for any contributions from the community. Look at our Contribution Guidelines.

Extension points exported contracts — how you extend this code

AmplifyAppSyncSimulatorDataLoader (Interface)
(no doc) [8 implementers]
packages/amplify-appsync-simulator/src/data-loader/index.ts
Planner (Interface)
(no doc) [32 implementers]
packages/amplify-cli/src/commands/gen2-migration/_common/planner.ts
PackageManager (Interface)
(no doc) [4 implementers]
packages/amplify-cli-core/src/utils/packageManager.ts
IAuthConfigRequirements (Interface)
* Auth resource configuration state. * requirementsMet is set to true if all required * configurations of the Auth res
packages/amplify-category-analytics/src/provider-utils/awscloudformation/service-walkthroughs/kinesis-walkthrough.ts
SocialProviderConfig (Interface)
* Defines a Cognito oAuth social provider
packages/amplify-headless-interface/src/interface/auth/add.ts
AmplifyRootStackTemplate (Interface)
(no doc) [2 implementers]
packages/amplify-cli-extensibility-helper/src/types/project/types.ts
IS3Service (Interface)
(no doc) [2 implementers]
packages/amplify-util-import/src/IS3Service.ts
IAmplifyLogger (Interface)
(no doc) [2 implementers]
packages/amplify-cli-logger/src/IAmplifyLogger.ts

Core symbols most depended-on inside this repo

expect
called by 7737
packages/amplify-e2e-core/src/utils/nexpect.ts
require
called by 1381
packages/amplify-velocity-template/tests/runner/mocha.js
push
called by 948
packages/amplify-cli/src/commands/gen2-migration/_common/spinning-logger.ts
send
called by 925
packages/amplify-cli/src/domain/amplify-usageData/UsageData.ts
log
called by 825
packages/amplify-e2e-gen2-migration/src/core/logger.ts
info
called by 555
packages/amplify-cli/src/commands/gen2-migration/_common/cfn.ts
error
called by 518
packages/amplify-e2e-gen2-migration/src/core/logger.ts
push
called by 498
packages/amplify-e2e-gen2-migration/src/core/app.ts

Shape

Function 5,419
Method 1,713
Class 667
Interface 381
Enum 97
Struct 3

Languages

TypeScript99%
Python1%
Java1%
Go1%

Modules by API surface

packages/amplify-cli/src/domain/amplify-toolkit.ts79 symbols
packages/amplify-velocity-template/tests/runner/mocha.js62 symbols
packages/amplify-e2e-core/src/utils/sdk-calls.ts57 symbols
packages/amplify-cli-core/src/errors/index.ts57 symbols
packages/amplify-e2e-gen2-migration/src/core/app.ts56 symbols
packages/amplify-e2e-tests/src/cleanup-e2e-resources.ts48 symbols
packages/amplify-e2e-tests/src/cleanup-codebuild-resources.ts48 symbols
packages/amplify-cli/src/commands/gen2-migration/generate/amplify/auth/auth.renderer.ts42 symbols
packages/amplify-category-storage/src/provider-utils/awscloudformation/service-walkthroughs/s3-user-input-state.ts40 symbols
packages/amplify-provider-awscloudformation/src/configuration-manager.ts38 symbols
packages/amplify-e2e-core/src/categories/auth.ts38 symbols
packages/amplify-e2e-core/src/utils/projectMeta.ts37 symbols

Dependencies from manifests, versioned

@aws-amplify/amplify-app5.0.48 · 1×
@aws-amplify/amplify-appsync-simulator2.16.20 · 1×
@aws-amplify/amplify-category-analytics5.0.47 · 1×
@aws-amplify/amplify-category-api5.15.3 · 1×
@aws-amplify/amplify-category-auth3.7.28 · 1×
@aws-amplify/amplify-category-custom3.1.33 · 1×
@aws-amplify/amplify-category-function5.8.2 · 1×
@aws-amplify/amplify-category-geo3.5.27 · 1×
@aws-amplify/amplify-category-hosting3.5.46 · 1×
@aws-amplify/amplify-category-interactions5.1.39 · 1×
@aws-amplify/amplify-category-notifications2.26.44 · 1×

For agents

$ claude mcp add amplify-cli \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact