/clerk-js

Official Javascript repository for Clerk authentication

Primary LanguageTypeScriptMIT LicenseMIT


Official Clerk JavaScript SDKs

This repository contains all the Clerk JavaScript SDKs under the @clerk/ namespace. Visit https://clerk.com to signup for an account.

chat on Discord documentation twitter


Clerk is Hiring!

Would you like to work on Open Source software and help maintain this repository? Apply today!.


Documentation and Usage

For how to get started with Clerk, you can refer to the official documentation page.

For JavaScript environments/platforms that Clerk supports, there should be a specific package corresponding to the respective technology.

npm install @clerk/clerk-sdk-node
# or
yarn add @clerk/clerk-sdk-node

Packages

For package specific details on installation, architecture and usage usage, you can refer to the package's README file.

Additionally there are packages which act as shared utilities or building blocks.

Setup

  • Clone the repository.
  • npm install.
  • npm run build.

* See the docs folder for additional repository documentation.

Cleanup

To clean existing builds and installed dependencies of the monorepo and setup again, run npm run nuke.

How to add a new localization key

  • Add the key types to the types package.
  • Add the corresponding localization values for every supported language in the localizations package
  • Replace the plain string (if there is one) with the localization value like so:
    <Text>Role</Text>
    becomes
    <Text localizationKey={localizationKeys('formFieldLabel__role')} />