Installation

Usage

The AuthKit Remix SDK provides utilities for integrating AuthKit authentication into Remix applications.

Refer to the AuthKit documentation for detailed usage instructions and examples.

Beta Versions

Certain WorkOS features may be available only in the beta version of the SDK. Beta versions have the -beta.* suffix, for example, 3.2.0-beta.1. For more information on how to use the beta versions, refer to the README in the GitHub repository.

Releases

December 4, 2025

v0.17.0

Latest
December 4, 2025

What's Changed

  • authLoader: Return organizationId to onSuccess callback by @mnemitz in #80
  • Add user roles support by @kendallstrautman in #82
  • Bump version to v0.17.0 by @kendallstrautman in #83

New Contributors

  • @mnemitz made their first contribution in #80
  • @kendallstrautman made their first contribution in #82

Full Changelog: v0.16.2...v0.17.0

August 22, 2025

v0.16.2

August 22, 2025

What's Changed

  • Fix infinite redirects with load balancer TLS termination by @nicknisi in #78

Full Changelog: v0.16.1...v0.16.2

August 8, 2025

v0.16.1

August 8, 2025

What's Changed

  • fix: use fresh user data when refreshing sessions by @nicknisi in #75

Full Changelog: v0.16.0...v0.16.1

August 5, 2025

v0.16.0

August 5, 2025

What's Changed

  • Fix: Preserve return pathname on session refresh failure by @nicknisi in #71
  • fix: return null user when access token is expired in withAuth by @nicknisi in #72

Full Changelog: v0.15.0...v0.16.0

August 1, 2025

v0.15.0

August 1, 2025

What's Changed

This version implements security improvements to the authentication system.

Changes

  • Modified the authentication data structure to improve security
  • Added a new getAccessToken() function for explicit access to authentication data
  • Updated documentation with security best practices

Breaking Changes

⚠️ This is a breaking change for applications that rely on access tokens being available in loader data.

See the updated README for migration instructions.

Full Changelog: v0.14.1...v0.15.0

June 28, 2025

v0.14.1

June 28, 2025

What's Changed

  • Fix: Preserve organizationId during token refresh by @nicknisi in #68

Full Changelog: v0.14.0...v0.14.1

June 25, 2025

v0.14.0

June 25, 2025

What's Changed

  • export switchToOrganization by @nicknisi in #66

Full Changelog: v0.13.0...v0.14.0

May 8, 2025

v0.13.0

May 8, 2025

What's Changed

  • Allow configuring session storage on callback route by @nicknisi in #64

Full Changelog: v0.12.0...v0.13.0

May 2, 2025

v0.12.0

May 2, 2025

What's Changed

  • Improve Header Handling from Loader Functions by @nicknisi in #59
  • Add a withAuth helper method by @nicknisi in #60
  • Add Session Refresh Callbacks by @nicknisi in #58
  • v0.12.0 by @nicknisi in #61

Full Changelog: v0.11.0...v0.12.0

April 18, 2025

v0.11.0

April 18, 2025

What's Changed

  • Add returnTo optional argument to signOut method by @nicknisi in #55
  • v0.11.0 by @nicknisi in #56

Full Changelog: v0.10.0...v0.11.0

April 8, 2025

v0.10.0

April 8, 2025

What's Changed

  • add switchToOrganization and refreshSession methods to remix SDK by @nicknisi in #53

Full Changelog: v0.9.1...v0.10.0

March 28, 2025

v0.9.1

March 28, 2025

What's Changed

  • fix: pass through non-JSON responses without modification in loader wrapper by @nicknisi in #50
  • v0.9.1 by @nicknisi in #51

Full Changelog: v0.9.0...v0.9.1

March 26, 2025

v0.9.0

March 26, 2025

What's Changed

  • Update library for latest version of remix / v3 features by @nicknisi in #45
  • Remove deprecated usage from README examples by @nicknisi in #49
  • v0.9.0 by @nicknisi in #48

Full Changelog: v0.8.0...v0.9.0

March 10, 2025

v0.8.0

March 10, 2025

What's Changed

  • Add test coverage to project by @nicknisi in #39
  • Add coana-guardrail and coana-analysis workflows by @nicknisi in #41
  • Allow for configurable Session Storage by @nicknisi in #40
  • Add programmatic configuration API by @nicknisi in #43
  • v0.8.0 by @nicknisi in #44

New Contributors

  • @nicknisi made their first contribution in #39

Full Changelog: v0.7.1...v0.8.0

December 12, 2024

v0.7.1

December 12, 2024

What's Changed

  • update authkit urls by @cosn in #36
  • Always set ttl to 0 by @PaulAsjes in #37

New Contributors

  • @cosn made their first contribution in #36

Full Changelog: v0.7.0...v0.7.1

December 3, 2024

v0.7.0

December 3, 2024

What's Changed

  • Move oauthTokens out of Session and make available via authLoader's new onSuccess option, by @mthadley in #33

Full Changelog: v0.6.0...v0.7.0

November 27, 2024

v0.6.0

November 27, 2024

What's Changed

  • Add entitlements to claims available from access token by @dandorman in #32

Full Changelog: v0.5.0...v0.6.0

November 15, 2024

v0.5.0

November 15, 2024

What's Changed

  • docs: fix missing code in README by @ajworkos in #29
  • Add oauthTokens support by @jonatascastro12 in #30

Full Changelog: v0.4.1...v0.5.0

November 4, 2024

v0.4.1

November 4, 2024

What's Changed

  • Update issue templates by @PaulAsjes in #23
  • fix: callback route fails when state is "null" by @ryanvanoss in #24
  • fix: variable undefined by @ryanvanoss in #25
  • Update logging strategy by @PaulAsjes in #27

New Contributors

  • @ryanvanoss made their first contribution in #24

Full Changelog: v0.4.0...v0.4.1

September 16, 2024

v0.4.0

September 16, 2024

What's Changed

  • Adds the sealed session to the auth data by @PaulAsjes in #21

Full Changelog: v0.3.1...v0.4.0

July 26, 2024

v0.3.1

July 26, 2024

What's Changed

  • Fix README issues by @chaance in #16
  • Preserve search params on return by @PaulAsjes in #17

Full Changelog: v0.3.0...v0.3.1

July 17, 2024

v0.3.0

July 17, 2024

What's Changed

  • Relax version of remix/node by @PaulAsjes in #12
  • Install prettier as dev dependency by @chaance in #14
  • Fix refresh token auth bug by @PaulAsjes in #11

New Contributors

  • @chaance made their first contribution in #14

Full Changelog: v0.2.0...v0.3.0

July 15, 2024

v0.2.0

July 15, 2024

What's Changed

  • Add support for fetching permissions JWT claim by @mattgd in #8
  • Increase copy-paste-ability of README examples by @chantastic in #1

Full Changelog: v0.1.0...v0.2.0

June 14, 2024

v0.1.0

June 14, 2024

Initial release! 🎉

Full Changelog: https://github.com/workos/authkit-remix/commits/v0.1.0