amplify-js: Open Source Monitoring & Observability

What is amplify-js?

What it is

AWS Amplify is a declarative JavaScript library for frontend and mobile developers who build cloud-enabled applications. It lives in the JavaScript and TypeScript ecosystem, published on npm as the aws-amplify package under the Apache-2.0 license, and it pairs with any JavaScript-based frontend workflow as well as React Native for mobile developers. The project has been developed for roughly nine years and is maintained by AWS, with its documentation hosted at docs.amplify.aws.

The concrete problem it solves is the gap between a frontend application and the cloud services that back it. Rather than hand-writing authentication flows, signed API requests, offline data synchronization, and file upload logic against individual service SDKs, developers call a single declarative interface that covers each of those categories. The default implementation targets Amazon Web Services, but the library is designed to be open and pluggable so that a custom backend or service can be substituted. It therefore replaces the boilerplate that would otherwise sit between a user interface and services such as Cognito, API Gateway, AppSync, Pinpoint, and S3.

Key capabilities

Authentication APIs and building blocks for creating authentication experiences, backed by Amazon Cognito.
Analytics collection for applications, including tracking of user sessions, backed by Amazon Pinpoint.
REST API access with SigV4 signing and AWS authentication for API Gateway and other REST endpoints.
GraphQL API interaction against a GraphQL or AWS AppSync endpoint.
DataStore, a programming model for shared and distributed data with online and offline synchronization.
Storage operations backed by Amazon S3.
A pluggable architecture that allows a custom backend or service in place of the default AWS provider.

Who uses it and how

Frontend developers who add sign-up, sign-in, and session handling to a web application through the Authentication category.
Mobile developers using React Native who need the same cloud categories from a native application.
Teams that collect product analytics and track user sessions through the Analytics category.
Applications that read and write shared data and must keep working when the device goes offline, using DataStore synchronization.
Developers who call existing REST endpoints with SigV4 signing or who query an AppSync GraphQL endpoint from the client.

Getting started

The library is installed from npm as the aws-amplify package, and the documentation site at docs.amplify.aws provides per-category getting-started guides for JavaScript. Version 6 is the current release, and upgrade guidance is published for projects moving from earlier versions.

When to use it — and when not to

It fits projects that are already committed to AWS services, because the default provider maps each category onto a specific AWS product and the value comes from that integration. A self-hoster or adopter must accept the AWS dependency for the default path, or invest in the pluggable interface to point at another backend. The main weakness visible in the facts is maintenance load: the repository carries 512 open issues, and all versions other than v5 and v6 are deprecated, so projects on v4 or below must upgrade to remain supported.

project readme (upstream, from github) — read inline

Reporting Bugs / Feature Requests

Note aws-amplify 6 has been released. If you are looking for upgrade guidance click here

⚠️ Deprecation Notice All AWS Amplify JavaScript library versions other than v5 and v6 are deprecated. Only v5.x.x and v6.x.x are actively supported. Versions v4 and below are deprecated. If you are using any version other than v5 or v6, we strongly recommend upgrading to v6 as soon as possible.

AWS Amplify is a JavaScript library for frontend and mobile developers building cloud-enabled applications

AWS Amplify provides a declarative and easy-to-use interface across different categories of cloud operations. AWS Amplify goes well with any JavaScript based frontend workflow and React Native for mobile developers.

Our default implementation works with Amazon Web Services (AWS), but AWS Amplify is designed to be open and pluggable for any custom backend or service.

Visit our documentation site to learn more about AWS Amplify. Please see the Amplify JavaScript page for information around the full list of features we support.

Contributing

Features

Category	AWS Provider	Description
Authentication	Amazon Cognito	APIs and Building blocks to create Authentication experiences.
Analytics	Amazon Pinpoint	Collect Analytics data for your application including tracking user sessions.
REST API	Amazon API Gateway	Sigv4 signing and AWS auth for API Gateway and other REST endpoints.
GraphQL API	AWS AppSync	Interact with your GraphQL or AWS AppSync endpoint(s).
DataStore	AWS AppSync	Programming model for shared and distributed data, with simple online/offline synchronization.
Storage	Amazon S3	Manages content in public, protected, private storage buckets.
Geo (Developer preview)	Amazon Location Service	Provides APIs and UI components for maps and location search for JavaScript-based web apps.
Push Notifications	Amazon Pinpoint	Allows you to integrate push notifications in your app with Amazon Pinpoint targeting and campaign management support.
Interactions	Amazon Lex	Create conversational bots powered by deep learning technologies.
PubSub	AWS IoT	Provides connectivity with cloud-based message-oriented middleware.
Internationalization	---	A lightweight internationalization solution.
Cache	---	Provides a generic LRU cache for JavaScript developers to store data with priority and expiration settings.
Predictions	Various*	Connect your app with machine learning services like NLP, computer vision, TTS, and more.

Predictions utilizes a range of Amazon's Machine Learning services, including: Amazon Comprehend, Amazon Polly, Amazon Rekognition, Amazon Textract, and Amazon Translate.

Getting Started

AWS Amplify is available as aws-amplify on npm.

To get started pick your platform from our Getting Started home page

Version Support

AWS Amplify JavaScript library v4 and below will end support on April 13, 2026, as documented in our AWS Amplify JavaScript library version support calendar.

Effective immediately, the AWS Amplify JavaScript library v4 and below will enter Maintenance Mode until April 13, 2026 after which it will receive no more updates. While in Maintenance Mode, the libraries will only receive updates for critical bug fixes and security vulnerabilities. Refer to Amplify Documentation for more information on the maintenance policy.

If you are using AWS Amplify JavaScript library v4 and below, we strongly recommend upgrading to the AWS Amplify JavaScript Library v6 before April 13, 2026.

Notice:

Amplify 6.x.x has breaking changes. Please see the breaking changes on our migration guide

Amplify 5.x.x has breaking changes. Please see the breaking changes below:

If you are using default exports from any Amplify package, then you will need to migrate to using named exports. For example:
```
- import Amplify f
```

Frequently asked questions

Is amplify-js free to use?

amplify-js is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does amplify-js do?

A declarative JavaScript library for application development using cloud services.

What is amplify-js written in?

amplify-js is primarily written in TypeScript. Its source is publicly available at https://github.com/aws-amplify/amplify-js, and it has 9,561 GitHub stars.