Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aws-amplify/amplify-cli
The AWS Amplify CLI is a toolchain for simplifying serverless web and mobile development.
https://github.com/aws-amplify/amplify-cli
analytics api authentication aws aws-amplify aws-appsync aws-fargate aws-lambda cli fullstack graphql lambda-functions mobile-development notifications predictions serverless serverless-containers storage web-development
Last synced: 12 days ago
JSON representation
The AWS Amplify CLI is a toolchain for simplifying serverless web and mobile development.
- Host: GitHub
- URL: https://github.com/aws-amplify/amplify-cli
- Owner: aws-amplify
- License: apache-2.0
- Created: 2018-08-23T16:33:10.000Z (about 6 years ago)
- Default Branch: dev
- Last Pushed: 2024-10-17T01:09:01.000Z (24 days ago)
- Last Synced: 2024-10-20T09:46:45.451Z (21 days ago)
- Topics: analytics, api, authentication, aws, aws-amplify, aws-appsync, aws-fargate, aws-lambda, cli, fullstack, graphql, lambda-functions, mobile-development, notifications, predictions, serverless, serverless-containers, storage, web-development
- Language: TypeScript
- Homepage:
- Size: 277 MB
- Stars: 2,813
- Watchers: 136
- Forks: 821
- Open Issues: 728
-
Metadata Files:
- Readme: Readme.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
### Reporting Bugs/Feature Requests
[](https://github.com/aws-amplify/amplify-cli/issues?q=is%3Aissue+is%3Aopen+label%3Abug)
[](https://github.com/aws-amplify/amplify-cli/issues?q=is%3Aissue+label%3Afeature-request+is%3Aopen)
[](https://github.com/aws-amplify/amplify-cli/issues?q=is%3Aissue+is%3Aclosed+)
> [!Important]
>
> # Amplify Gen 2 is now generally available
>
> If you are starting a new project, we recommend starting with [Amplify Gen 2](https://github.com/aws-amplify/amplify-backend).
>
> If you are an existing Gen 1 customer, we recommend that you continue working with your Gen 1 Amplify project. We are actively developing migration tooling to aid in transitioning your project from Gen 1 to Gen 2. We remain committed to supporting both Gen 1 and Gen 2 for the foreseeable future.
>
> Customers on Gen 1 will continue to receive support for high-priority bugs and essential security updates.
# 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](#install-the-cli)
- [Commands Summary](#commands-summary)
- [Tutorials](#tutorials)
- [Contributing](#contributing)
- [Start building your app](https://aws-amplify.github.io/docs)
- [Changelog](https://github.com/aws-amplify/amplify-cli/releases/latest)
## Install the CLI
- Requires Node.js® version 18 or later
Install and configure the Amplify CLI as follows:
```bash
$ 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 `` | Adds cloud features to your app. |
| amplify update `` | 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 [ ``...] | Displays the state of local resources that haven't been pushed to the cloud (Create/Update/Delete). |
| amplify status -v [ ``...] | 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 `` 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](https://docs.amplify.aws/cli/teams/overview). |
### Category specific commands:
- [auth (Amazon Cognito)](packages/amplify-category-auth/Readme.md)
- [storage (Amazon S3 & Amazon DynamoDB)](packages/amplify-category-storage/Readme.md)
- [function (AWS Lambda)](packages/amplify-category-function/Readme.md)
- [api (AWS AppSync & Amazon API Gateway)](packages/amplify-category-api/Readme.md)
- [analytics (Amazon Pinpoint)](packages/amplify-category-analytics/Readme.md)
- [hosting (Amazon S3 and Amazon CloudFront distribution)](packages/amplify-category-hosting/Readme.md)
- [notifications (Amazon Pinpoint)](packages/amplify-category-notifications/Readme.md)
- [interactions (Amazon Lex)](packages/amplify-category-interactions/Readme.md)
- [predictions (Amazon Rekognition, Amazon Textract, Amazon Translate, Amazon Polly, Amazon Transcribe, Amazon Comprehend, and Amazon SageMaker)](packages/amplify-category-predictions/Readme.md)
## Tutorials
- [Getting Started guide](https://docs.amplify.aws/start)
- [GraphQL transform tutorial](https://docs.amplify.aws/cli/graphql-transformer/overview)
- [Native development with Amplify CLI and AWS AppSync](https://docs.amplify.aws/cli/graphql-transformer/codegen)
## Developing
To set up your local development environment, go to [Local Environment Setup](https://github.com/aws-amplify/amplify-cli/blob/dev/CONTRIBUTING.md#local-environment-setup).
To test your category, do the following:
```sh
cd
amplify-dev init
amplify-dev
```
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](https://github.com/aws-amplify/amplify-cli/blob/dev/CONTRIBUTING.md).