workos

AuthKit: Add WorkOS Authentication to Your App

AuthKit provides examples for adding WorkOS authentication through a hosted, themeable login UI or a custom interface using headless User Management APIs. It suits teams building web apps that want WorkOS to handle authentication flows.

MaintainedTypeScriptMITWeb AppFrontendAuthentication
View on GitHub Compare
Stars
3.4k
Forks
169
Stars, last 30 days
+6
Last commit
1 month ago
Contributors
13

Our take

Maintaineda few commits in the last 90 days

Health score

46/100

How it is scored
Activity
29
Community
54
Issues
53
Pull requests
46

+6 stars in the last 30 days

AuthKit is a useful WorkOS integration reference with both hosted and custom UI paths, though its recent development activity is light and it has no recent releases.

Good fit if

  • Your application uses Node.js and you plan to use WorkOS User Management.
  • You want to compare a hosted login UI with a custom UI backed by headless APIs.
  • You prefer an MIT-licensed example project and can adapt it to your application.

Look elsewhere if

  • You need an authentication solution that does not depend on a WorkOS account and dashboard configuration.
  • You need evidence of recent releases or frequent repository changes before adopting an integration example.
  • You need a project with included tests or CI, neither of which is indicated in the repository data.
All health signals
Last commit2026-09-10 (1 month ago)
Commits, last 90 days2
Releases, last 12 months0
Contributors13 (top contributor: 49% of commits)
Issues closed, last 90 days2
Pull requests merged, last 90 days2
Project age2 years

Checked on 2026-10-14 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

3,360

Forks

171

Change since Nov 18, 2026: 0 stars·0 forks

Overview

AuthKit is a TypeScript example project showing two ways to add WorkOS User Management to an application: send users through WorkOS's hosted authentication UI, or build and host your own UI using the headless APIs. It helps teams choose between a ready-made login experience and direct control over their authentication screens.

The repository is best understood as an implementation reference rather than a standalone authentication service. Both paths require a WorkOS account and configuration in its dashboard.

Key Features

  • Demonstrates a hosted UI that handles authentication flows and can be themed.
  • Includes examples for integrating a custom, self-hosted authentication UI with WorkOS User Management APIs.
  • Shows OAuth sign-in callback configuration for Google, Microsoft, and GitHub.
  • Includes an SSO callback example.
  • Demonstrates hosted AuthKit with and without session and Next.js examples.
  • Provides a local development setup using Node.js and environment variables for WorkOS credentials.

Use Cases

  • A product team wants to get a WorkOS-backed sign-in experience running quickly, and is comfortable using the hosted UI.
  • A frontend team needs a custom-branded login interface and wants an example of integrating the headless User Management APIs.
  • Developers evaluating hosted versus self-hosted authentication UI can compare both approaches in one project.
  • A team configuring social OAuth or SSO sign-in can use the callback examples as a starting point.

What you need

Detected in the repository

  • Node.js (from package.json)

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install dependencies and start the example locally:

npm install
npm run dev

Set the WorkOS credentials and configure redirect URLs as described in the README.

Alternatives

  • supertokens-core: SuperTokens Core is a self-hostable authentication service, while AuthKit demonstrates using WorkOS-hosted or headless authentication flows.
ProjectLanguageLicenseStarsStatus
AuthKitTypeScriptMIT3.4kMaintained
supertokens-coreJavaOther15.3kActive

Considerations

The project is marked maintained, but has had only a few commits recently and no release in the past year. It has contributions from multiple people, without measured contributor concentration, so the available activity signals do not point to dependence on one contributor. The repository data indicates no tests or CI, which means teams should validate any adapted integration themselves. You will also need a WorkOS account, API credentials, and correctly configured redirect URLs.

Found this useful?

Share it with someone who would like AuthKit.

Comparisons