Authgear SDK for Single Page Applications (SPA)

With Authgear SDK for Single Page Applications (SPA), you can easily integrate authentication features into your app (Angular, Vue, React, or any JavaScript websites). In most cases, it involves just a few lines of code to enable multiple authentication methods, such as social logins, passwordless, biometrics logins, one-time-password (OTP) with SMS/WhatsApp, and multi-factor authentication (MFA).

Quick links - 📚 Documentation 🏁 Getting Started 🛠️ Troubleshooting 👥 Contributing

What is Authgear?

Authgear is a highly adaptable identity-as-a-service (IDaaS) platform for web and mobile applications. Authgear makes user authentication easier and faster to implement by integrating it into various types of applications - from single-page web apps to mobile applications to API services.

Key Features

• Zero trust authentication architecture with OpenID Connect (OIDC) standard.
• Easy-to-use interfaces for user registration and login, including email, phone, username as login ID, and password, OTP, magic links, etc for authentication.
• Support a wide range of identity providers, such as Google, Apple, and Azure Active Directory (AD).
• Support biometric login on mobile, Passkeys, and Multi-Factor Authentication (MFA) such as SMS/email-based verification and authenticator apps with TOTP.

Documentation

• View the SDK API Reference at https://authgear.github.io/authgear-sdk-js/.
• Learn how to manage your users through Admin API.

View other Authgear Documentation at https://docs.authgear.com/

Getting Started

Follow the easy steps to start using it:

• Getting started with Authgear SDK

Troubleshooting

Please check out our Get help to get solutions for common installation problems and other issues.

Raise an issue

To provide feedback or report a bug, please raise an issue on our issue tracker.

Contributing

Anyone who wishes to contribute to this project, whether documentation, features, bug fixes, code cleanup, testing, or code reviews, is very much encouraged to do so.

To join, just raise your hand on the Authgear Discord server (#trouble) or the GitHub Authgear's discussion board.

If you are unfamiliar with how to contribute to GitHub projects, here is a Getting Started Guide. A full set of contribution guidelines, along with templates, are in progress.

Or here is a quick way.

$ git clone --branch master [email protected]:<myusername>/authgear-sdk-js.git
$ cd authgear-sdk-js
$ npm ci
$ (cd website && yarn install --frozen-lockfile)

Releasing

1. Ensure you have node, npm, yarn, sed, git in your PATH.
2. Run npm run set-version VERSION to set the version. VERSION should be without the v at the beginning, for example, 1.0.0.
3. Commit the change.
4. Create a pull request for this change.
5. Wait for merge.
6. Run git tag -a vVERSION -m "Release vVERSION" MERGE_COMMIT. MERGE_COMMIT should be the commit hash of the merge commit.
7. Push the tag to github.com/authgear/authgear-sdk-js.

Known issues

Apple silicon

See facebook/react-native#29605 (comment)

Supported and maintained by

Auhgear is a highly adaptable identity-as-a-service (IDaaS) platform for web and mobile applications. To learn more checkout website