jose is a free, open source browsers & extensions project written in TypeScript and released under MIT. It has 7,795 GitHub stars, 378 forks and 0 open issues, and was last pushed 4 days ago. On this registry it ranks #46 of 101 tracked projects in Browsers & Extensions, with 5 head-to-head comparisons available.

What is jose?

jose is an MIT-licensed TypeScript module for JSON Object Signing and Encryption — JSON Web Tokens (JWT), JSON Web Signature (JWS), JSON Web Encryption (JWE), JSON Web Key (JWK) and JSON Web Key Set (JWKS) — that runs on Node.js, browsers, Cloudflare Workers, Deno, Bun and other Web-interoperable runtimes.

What it is

jose is a JavaScript module published to npmjs.com as jose and to jsr.io as @panva/jose, with additional distribution through jsdelivr.com and GitHub. It implements the JOSE family of standards: JWA for algorithms, JWS for signatures and MACs, JWE for encryption, JWT for signed and encrypted token claims sets, and JWK/JWKS for key material. The module ships as tree-shakeable ESM and has zero dependencies, so nothing is pulled in transitively.

The concrete problem it solves is runtime portability of token cryptography. An application that must verify a JWT in a Node.js service, in a browser, and in a Cloudflare Worker can use one set of functions rather than separate code paths per runtime. The library also normalises key handling across formats, importing and exporting JWK, SPKI public keys, X.509 certificates and PKCS #8 private keys, and it resolves signing keys from a published JWKS through createRemoteJWKSet, so key rotation does not require redeploying the verifier.

Key capabilities

  • JWT verification and claims set validation through jwtVerify, with remote key resolution via createRemoteJWKSet and local JWKS via createLocalJWKSet.
  • JWT signing with the SignJWT class, and encrypted tokens through jwtDecrypt and the EncryptJWT class.
  • Token inspection helpers decodeProtectedHeader and decodeJwt, the latter used to read a claims set before it is validated.
  • JWS signing and verification over arbitrary payloads in Compact, Flattened JSON and General JSON serializations, using CompactSign, FlattenedSign, GeneralSign, compactVerify, flattenedVerify and generalVerify per RFC 7515 Section 7.
  • Key utilities covering import (importJWK, importSPKI, importX509, importPKCS8), generation (generateKeyPair, generateSecret) and export (exportJWK, exportPKCS8, exportSPKI).
  • A dependency-free, tree-shakeable ESM build.

Who uses it and how

  • Edge and serverless deployments on Cloudflare Workers, Deno and Bun, which the project lists as first-class targets alongside Node.js and the browser.
  • Node.js services that issue tokens with SignJWT and validate inbound ones with jwtVerify.
  • Browser code that needs to read a token's protected header or claims set with decodeProtectedHeader and decodeJwt.
  • Applications that consume an identity provider's published JWKS, using createRemoteJWKSet so key rotation is picked up without a deploy.
  • Services that need confidentiality as well as integrity, encrypting tokens with EncryptJWT and reading them back with jwtDecrypt.

Getting started

jose is distributed via npmjs.com, jsr.io (@panva/jose), jsdelivr.com and GitHub; the documented ESM entry point is import * as jose from 'jose'. No build step or server component is required to begin using it.

How it compares

The facts provided name no list of paid products that jose replaces. Among the tools it is associated with, the jsonwebtoken topic appears in its own tag list, which places jose in the same JWT handling territory while its stated scope is Web-interoperable runtimes rather than one runtime. The README's sponsor note points readers who want a managed path to Auth0's JavaScript SDK and free plan, which is a hosted offering rather than an alternative implementation.

When to use it — and when not to

A self-hoster adopting jose has to operate the surrounding auth infrastructure themselves: key generation and storage, JWKS publication and rotation, algorithm selection, and claims policy. It is a library, not a service, so there is no database, SMTP or hosted option in this registry to run — the operational burden is key management and correct verification logic. Teams that want a managed authentication flow should look at hosted options such as the Auth0 JavaScript SDK referenced in the README, and anyone unwilling to own cryptographic policy should not treat the library as an out-of-the-box auth system.

project readme (upstream, from github) — read inline

jose

jose is a JavaScript module for JSON Object Signing and Encryption, providing support for JSON Web Tokens (JWT), JSON Web Signature (JWS), JSON Web Encryption (JWE), JSON Web Key (JWK), JSON Web Key Set (JWKS), and more. The module is designed to work across various Web-interoperable runtimes including Node.js, browsers, Cloudflare Workers, Deno, Bun, and others.

Sponsor

Auth0 by Okta

If you want to quickly add JWT authentication to JavaScript apps, feel free to check out Auth0's JavaScript SDK and free plan. Create an Auth0 account; it's free!

💗 Help the project

Support from the community to continue maintaining and improving this module is welcome. If you find the module useful, please consider supporting the project by becoming a sponsor.

Dependencies: 0

jose has no dependencies and it exports tree-shakeable ESM[^cjs].

Documentation

jose is distributed via npmjs.com, jsr.io, jsdelivr.com, and github.com.

example ESM import[^cjs]

import * as jose from 'jose'

JSON Web Tokens (JWT)

The jose module supports JSON Web Tokens (JWT) and provides functionality for signing and verifying tokens, as well as their JWT Claims Set validation.

Encrypted JSON Web Tokens

The jose module supports encrypted JSON Web Tokens and provides functionality for encrypting and decrypting tokens, as well as their JWT Claims Set validation.

Key Utilities

The jose module supports importing, exporting, and generating keys and secrets in various formats, including PEM formats like SPKI, X.509 certificate, and PKCS #8, as well as JSON Web Key (JWK).

JSON Web Signature (JWS)

The jose module supports digital signature and MAC computation and validation over arbitrary JWS Payloads using the JWS Compact Serialization and the flattened and general JWS JSON Serialization syntaxes (RFC 7515, Section 7).

JSON Web Encryption (JWE)

The jose module supports encryption and authenticated decryption of arbitrary plaintext using the JWE Compact Serialization and the flattened and general JWE JSON Serialization syntaxes (RFC 7516, Section 7).

Other

The following are additional features and utilities provided by the jose module:

Supported Runtimes

The jose module is compatible with JavaScript runtimes that support the utilized Web API globals and standard built-in objects or are Node.js.

The following runtimes are supported (this is not an exhaustive list):

Please note that certain algorithms may not be available depending on the runtime used. You can find a list of available algorithms for each runtime in the specific issue links provided above.

Supported Versions

Version Security Fixes 🔑 Other Bug Fixes 🐞 New Features ⭐ Runtime and Module type
v6.x Security Policy Universal[^universal] ESM[^cjs]

Specifications

Details
  • JSON Web Signature (JWS) - RFC7515
  • JSON Web Encryption (JWE) - RFC7516
  • JSON Web Key (JWK) - RFC7517
  • JSON Web Algorithms (JWA) - RFC7518
  • JSON Web Token (JWT) - RFC7519
  • JSON Web Key Thumbprint - RFC7638
  • JSON Web Key Thumbprint URI - RFC9278
  • JWS Unencoded Payload Option - RFC7797
  • CFRG Elliptic Curve ECDH and Signatures - RFC8037
  • Fully-Specified Algorithms for JOSE - RFC9864
  • ML-DSA for JOSE - RFC9964

The algorithm implementations in jose have been tested using test vectors from their respective specifications as well as RFC7520.

[^c

readme truncated — read the full docs on github

Frequently asked questions

Is jose free to use?

jose is open source under the MIT 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 jose do?

JWA, JWS, JWE, JWT, JWK, JWKS for Node.js, Browser, Cloudflare Workers, Deno, Bun, and other Web-interoperable runtimes

What is jose written in?

jose is primarily written in TypeScript. Its source is publicly available at https://github.com/panva/jose, and it has 7,795 GitHub stars.