# netlify/gotrue

An JWT based API for managing users and issuing JWT tokens.

Repository: https://github.com/netlify/gotrue
Canonical: https://ross.abutalabs.com/products/gotrue
Homepage: https://www.gotrueapi.org
Language: Go
License: MIT
License Family: permissive
Topics: authentication, jwt, production
Last push: 2026-07-24T23:58:35+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 94, release rhythm 8, longevity 100
- inputs: {"age_days": 3761, "days_push": 40, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4462, forks 329 (observed 2026-08-28T04:08:50.749064+00:00)

## What it is
GoTrue is a small open-source API written in Go that handles user registration, authentication, and user management for APIs and Jamstack projects. It is based on OAuth2 and JWT, issuing JWT tokens and supporting signup, login, invites, and custom user data backed by a MySQL database.

## Use cases
- add user signup and login to a Jamstack site
- self-host a JWT-based authentication API
- manage users and issue JWT tokens for my app
- handle email invites and password recovery for users
- run a standalone identity service behind my API gateway
- store custom user metadata alongside authentication

## When to choose
- you need a self-hosted, lightweight user management microservice
- your stack is Jamstack or Netlify-based and speaks JWT
- you want OAuth2/JWT auth without building it yourself

## When to avoid
- you need databases other than MySQL
- you want a full-featured identity provider with SSO/SAML or social login breadth
- you prefer a managed auth service rather than operating your own

## Facets
- artifact type: service
- maturity: maintenance
- function: auth, http-server, api-framework, rate-limiting
- domain: security, backend, web-development, apis, self-hosted
- platform: go, self-hosted, windows
- tags: jwt, oauth2, user-management, jamstack, identity, signup, microservice, docker, web-server, linux, macos

## Member repositories
- netlify/gotrue (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:50.749064+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:20:41.433813+00:00, confidence not recorded.
  - readme: https://github.com/netlify/gotrue (fetched 2026-08-28T04:08:50.749064+00:00, sha e9f65a96c8b8)
- Data as of 2026-08-30T08:39:29.467469+00:00.