Guide

Stack Auth devient Hexclave, et que faire

Stack Auth est devenu Hexclave fin mai 2026 : preuves du renommage, licences MIT et AGPLv3, migration @stackframe vers @hexclave, tarifs et alternatives.

L'équipe CodeWorlds17 min de lecture ·

Pratique HTML et CSS dans des leçons interactives avec un éditeur de code.

Crée un compte gratuit→
Dans cet article9

Le nom Stack Auth a cessé de s'appliquer fin mai 2026. Le dépôt stack-auth/stack-auth redirige désormais vers hexclave/hexclave, le domaine stack-auth.com redirige vers www.hexclave.com, et les paquets @stackframe/* ont été remplacés par la famille @hexclave/*. Le service et les données sont restés les mêmes ; l'image de marque a changé, et le périmètre déclaré du produit aussi.

Preuves du renommage

Plutôt que de croire ce dont un moteur de recherche se souvient, tu peux vérifier toi-même les redirections. Trois commandes suffisent pour voir où mènent les anciennes adresses.

Bash
# repository: the old address ends up on the hexclave account
curl -sL -o /dev/null -w "%{http_code} %{url_effective}\n" https://github.com/stack-auth/stack-auth

# product site
curl -sL -o /dev/null -w "%{http_code} %{url_effective}\n" https://stack-auth.com

# documentation
curl -sL https://docs.stack-auth.com | grep -i "<title>"

Les deux premières renvoient 200 avec les adresses cibles https://github.com/hexclave/hexclave et https://www.hexclave.com/. La troisième renvoie une page intitulée Redirecting to Hexclave Docs. La redirection du dépôt fonctionne aussi pour la variante intermédiaire : github.com/hexclave/stack-auth atterrit au même endroit, ce qui signifie que le compte de l'organisation a été renommé en même temps que le dépôt.

La date peut être resserrée grâce au registre npm, où les dates de publication sont des faits solides. La dernière version de @stackframe/stack est la 2.8.108 du 26 mai 2026. La première version du paquet @hexclave/js est apparue le 27 mai 2026. Un paquet réservé sans portée, nommé hexclave, a été publié encore plus tôt, le 23 mai 2026, ce qui ressemble à une réservation de nom quelques jours avant l'opération elle-même. Un paquet de l'ancienne famille est sorti après l'échéance : @stackframe/stack-shared est à la 2.8.109 du 28 mai 2026, deux jours après les autres.

Je n'ai trouvé aucune annonce officielle. Le blog de hexclave.com compte six articles et aucun ne traite du renommage. Le plus ancien, à /blog/introducing-stack, s'intitule aujourd'hui « Introducing Hexclave, the open-source user management service » et date du 14 avril 2024, et le corps de la page ne contient ni la chaîne « Stack Auth » ni « stackframe ». L'ancien contenu a été réécrit à la nouvelle marque sans note, même si l'adresse de l'article trahit encore le nom d'origine. La page du changelog n'affiche pas ses entrées sans JavaScript, donc je ne peux pas confirmer si une note de changement de marque s'y trouve. Le seul endroit qui nomme directement la chose est docs.hexclave.com/migration, qui s'ouvre sur la phrase disant que Stack Auth est maintenant Hexclave.

Seule l'image de marque a-t-elle changé

L'ancienne description du paquet @stackframe/stack, encore visible dans le registre npm, parle d'un service d'authentification managé. Le nouveau dépôt se présente comme « The user infrastructure platform » et liste un catalogue d'applications que tu actives selon tes besoins.

La liste du README couvre l'authentification, les équipes, le contrôle d'accès par rôles, les clés d'API, les paiements, les e-mails, un coffre pour les données sensibles des utilisateurs, les webhooks et une checklist de lancement avant production. La documentation destinée aux agents ajoute la protection contre la fraude, une intégration Vercel, l'analytique, les clickmaps et les replays de session. Le périmètre s'est réellement élargi et ce n'est pas que du marketing, l'arbre des dépendances le montre. Les paquets de frameworks, @hexclave/react et @hexclave/next, tirent rrweb pour l'enregistrement des sessions, @stripe/stripe-js avec @stripe/react-stripe-js pour les paiements, et ai version 6 avec @ai-sdk/react. La dernière version de @stackframe/stack portait déjà les mêmes dépendances, donc l'expansion du produit a commencé avant le renommage. Le cœur indépendant du framework, @hexclave/js, est nettement plus léger : de cet ensemble il ne contient que rrweb, et treize dépendances de production au total.

La conséquence pratique est qu'installer le paquet React ou Next.js juste pour ajouter la connexion fait aussi entrer un client Stripe et une bibliothèque d'enregistrement de sessions dans ton arbre de dépendances, que tu prévoies de les utiliser ou non. Si tu surveilles la taille du bundle ou la liste des sous-traitants qui manipulent tes données, c'est un coût réel plutôt qu'un détail, et il vaut la peine de vérifier si le seul cœur @hexclave/js suffit.

Le backend d'analytique tourne sur ClickHouse, ce qui se voit à la méthode queryAnalytics qui accepte du SQL brut. Pratique pour déboguer, et en même temps cela te lie à un moteur précis si tu auto-héberges.

La licence vérifiée auprès de trois sources

C'est ici que cela devient intéressant, car trois sources disent trois choses différentes et aucune n'est complète.

La première source, le fichier LICENSE à la racine du dépôt, n'est pas une licence. C'est un texte de cinq lignes qui indique que le projet est sous licence par paquet, le code client et les exemples sous MIT, les composants serveur sous AGPLv3, avec des licences commerciales disponibles sur demande par e-mail. Le texte s'ouvre encore par le mot « Stack », même si l'adresse de contact a été changée pour le domaine hexclave. Les vraies licences se trouvent plus profond : apps/backend/LICENSE et apps/dashboard/LICENSE contiennent le texte complet de l'AGPLv3, et packages/template/LICENSE contient le texte complet du MIT avec une mention « Copyright 2024 Stackframe ».

La deuxième source, le champ license du registre npm, n'existe tout simplement pas. Il manque pour @stackframe/stack 2.8.108, pour @stackframe/js, pour @hexclave/js 1.0.102, pour @hexclave/next, pour @hexclave/react et pour @hexclave/tanstack-start. Un champ absent sur six paquets d'affilée n'est pas un accident mais un état de longue date. Le fichier packages/js/package.json du dépôt le confirme, car il n'a pas non plus de clé license. L'exception est @hexclave/cli, qui déclare MIT.

La troisième source, le contenu du paquet publié, s'en sort le mieux. Le tarball de @hexclave/js 1.0.102 contient package/LICENSE avec le texte complet du MIT, 1058 octets, portant la mention « Copyright 2024 Stackframe ». Exactement le même fichier, octet pour octet, se trouve dans @stackframe/stack 2.8.108. Le fichier n'existe pas sur la branche principale sous packages/js/LICENSE, même si le tableau files du manifeste le liste, donc il est ajouté pendant le build, très probablement depuis le paquet template. Cette dernière partie est mon inférence, pas une déclaration de l'éditeur.

Une bizarrerie à part : @hexclave/cli déclare MIT dans son manifeste, mais le fichier LICENSE à l'intérieur de son paquet ne contient pas une licence mais le même texte de cinq lignes qui renvoie aux licences par paquet. La déclaration et la pièce jointe disent des choses différentes.

Plusieurs conséquences pour un audit de dépendances. Les outils qui ne lisent que le champ license du registre signaleront les paquets Hexclave comme inconnus, et certaines politiques d'entreprise les bloqueront. Les outils qui analysent les fichiers à l'intérieur de node_modules trouveront du MIT et le laisseront passer. Le dépôt dans son ensemble place l'AGPLv3 sur les parties serveur, donc l'auto-hébergement t'entraîne dans l'AGPL, avec une licence commerciale comme issue. La mention de copyright nomme encore l'ancienne société, ce que tu devras pouvoir expliquer lors d'une revue juridique formelle.

Migrer de @stackframe vers @hexclave

Le guide de migration existe et il est précis. La correspondance des paquets se présente ainsi.

Ancien paquetNouveau paquetDernière version de l'ancienVersion du nouveau
@stackframe/stack@hexclave/next2.8.108 (26 mai 2026)1.0.102 (20 août 2026)
@stackframe/react@hexclave/reactla famille 2.8.x1.0.102
@stackframe/js@hexclave/js2.8.108 (26 mai 2026)1.0.102 (20 août 2026)

Remarque le piège de la première ligne : le paquet appelé stack correspond au paquet appelé next, pas à js. Renommer par une substitution de texte naïve introduit un bug.

Bash
npm uninstall @stackframe/stack
npm install @hexclave/next

L'API publique est restée la même ; seul le préfixe Stack a été renommé en Hexclave.

TypeScript
// before
import { StackClientApp, StackProvider, useStackApp } from "@stackframe/stack";

// after
import { HexclaveClientApp, HexclaveProvider, useHexclaveApp } from "@hexclave/next";

Les anciens noms fonctionnent encore comme alias. On le voit dans les déclarations de types du paquet publié : @hexclave/js exporte côte à côte HexclaveServerApp et StackServerApp, HexclaveClientApp et StackClientApp, defineHexclaveConfig et defineStackConfig. Symétriquement, la dernière version de @stackframe/stack exporte déjà HexclaveServerApp, ce qui signifie que les nouveaux noms sont arrivés dans l'ancien paquet avant la redirection des domaines.

Le constructeur prend les mêmes options qu'avant.

TypeScript
import { HexclaveServerApp } from "@hexclave/next";

export const hexclaveServerApp = new HexclaveServerApp({
  tokenStore: null,
  urls: {
    default: {
      type: "hosted",
    },
  },
});

La valeur de tokenStore est "nextjs-cookie" pour Next.js, "cookie" pour les autres frontends de navigateur et null pour les environnements purement côté serveur. Pour urls.default.type, la documentation recommande désormais "hosted" plutôt que l'ancien "handler", et la variante hébergée ne génère plus de chemins comme /handler/sign-in.

Deux changements sont nécessaires en dehors des imports. L'adresse codée en dur https://api.stack-auth.com devient https://api.hexclave.com. Si tu vérifies toi-même les JWT, tu corriges l'émetteur attendu, car le nouveau SDK signe sous le nouveau domaine.

TypeScript
const { payload } = await jose.jwtVerify(token, jwks, {
  issuer: 'https://api.hexclave.com/api/v1/projects/YOUR_PROJECT_ID',
  audience: 'YOUR_PROJECT_ID',
});

Il en va de même pour les variantes d'émetteur pour les utilisateurs anonymes et restreints, c'est-à-dire les chemins /api/v1/projects-anonymous-users/ et /api/v1/projects-restricted-users/. Le reste est facultatif : les en-têtes X-Stack-* peuvent être renommés en X-Hexclave-*, les variables d'environnement STACK_* en HEXCLAVE_*, et les tokens avec le préfixe stackauth_ restent valides. Les URL de callback OAuth qui pointent vers l'ancien domaine continuent de fonctionner, mais un fournisseur recréé de zéro dans le dashboard recevra une adresse sur le domaine hexclave.

Une chose ne migre pas sans douleur. Les pages hébergées sont passées du sous-domaine .built-with-stack-auth.com à .built-with-hexclave.com, et les passkeys sont liées au domaine où elles ont été enregistrées et ne se transfèrent pas entre les deux. Si tu as des utilisateurs avec des passkeys sur l'ancien domaine, prévois une nouvelle inscription.

L'outil en ligne de commande a changé de nom de binaire. L'ancien programme stack n'est plus publié et sa place est prise par hexclave du paquet @hexclave/cli.

JSON
{
  "scripts": {
    "dev": "hexclave dev --config-file ./hexclave.config.ts -- npm run dev:inner",
    "dev:inner": "next dev"
  }
}

La commande hexclave dev injecte HEXCLAVE_PROJECT_ID et HEXCLAVE_SECRET_SERVER_KEY dans le processus enfant, y compris des copies préfixées NEXT_PUBLIC_ et VITE_ pour les valeurs non sensibles.

Ce qui arrive aux anciens paquets

La documentation de migration dit sans détour que rester sur l'ancien SDK n'exige aucune action, car api.stack-auth.com et api.hexclave.com pointent vers le même service. Cela répond à la question de savoir si ton projet cesse de fonctionner lundi. Non.

Ce que la documentation ne dit pas, c'est si les anciens paquets recevront encore des versions. Les faits du registre suggèrent que non : @stackframe/stack est à la 2.8.108 depuis le 26 mai 2026, soit près de trois mois, tandis que la famille @hexclave/* a livré d'autres versions jusqu'à la 1.0.102 le 20 août. Je n'ai trouvé aucune déclaration de fin de support, mais aucune promesse de correctifs de sécurité pour les anciens paquets non plus. Pour une bibliothèque d'authentification, c'est une raison suffisante de planifier la migration, même si rien ne brûle aujourd'hui.

Ce n'est pas un projet factice abandonné après deux versions. @stackframe/stack compte 225 versions publiées remontant à mars 2024, et @hexclave/js en a atteint 98 en moins de trois mois. Le dépôt hexclave/hexclave compte 6842 étoiles et 522 forks, n'est pas archivé, et des versions apparaissent dans le flux atom tous les quelques jours. Le nom a été abandonné, pas le code.

Le paquet npm nu hexclave est un cas à part. Version 0.0.1 du 23 mai 2026, licence MIT, trois fichiers, 660 octets décompressés. Tout son contenu est un script qui affiche un message et sort avec un code d'erreur. Pire, le message et le README se contredisent : la description du paquet et le README pointent vers @hexclave/hexclave, qui n'existe pas dans le registre npm, tandis que le script du binaire pointe vers @hexclave/cli, qui existe et est le véritable outil. C'est un paquet qui réserve un nom, avec des instructions périmées à l'intérieur. Ne l'installe pas et ne le prends pas pour un point d'entrée.

Deux autres choses à vérifier dans ton lockfile pendant que tu y es. Les paquets de la famille sont figés sur une seule version : @hexclave/next 1.0.102 exige exactement @hexclave/ui 1.0.102, @hexclave/sc 1.0.102 et @hexclave/shared 1.0.102, donc mélanger les versions ne se résoudra pas. La plage de peer dependency pour React a été abaissée en chemin : @stackframe/stack exigeait react en 18.3.0 ou plus, tandis que @hexclave/next accepte >=18.0.0. La plage de Next.js est inchangée, c'est-à-dire >=14.1 avec les release candidates de la version 15 autorisées.

Tarifs sous le nouveau nom

Les tarifs sont publiés et s'affichent sans JavaScript, donc les chiffres ci-dessous viennent directement de la page hexclave.com/pricing.

PlanPrixUtilisateursE-mails par moisÉvénements d'analytique
Free0 USD10 0001 000100k
Team49 USD par mois50 00025 000500k
Growth299 USD par moisillimité25 0001m

Quelques détails sont faciles à manquer. Le plan gratuit donne un administrateur de dashboard, les plans payants quatre chacun, et chaque administrateur supplémentaire coûte 29 USD par mois. Le quota d'e-mails n'augmente pas entre le plan à 49 dollars et celui à 299 dollars ; les deux s'arrêtent à 25 000 messages. Le quota de replays de session est de 2 500 par mois sur les trois plans, le gratuit compris. Ce qui augmente, c'est le délai d'expiration des requêtes d'analytique, de 10 secondes à 60 secondes puis à 5 minutes. Il n'y a pas de prix annuel, donc rien à multiplier par douze. Un utilisateur d'authentification désigne tout compte du projet, les comptes inactifs compris, ce qui peut surprendre les anciens projets avec une longue traîne de comptes morts.

L'auto-hébergement est gratuit et l'éditeur le met en avant, avec la réserve mentionnée plus haut : le côté serveur est sous AGPLv3, et l'alternative est une licence commerciale payante.

Quoi utiliser à la place si tu préfères ne pas suivre

Un renommage n'est pas en soi une raison de fuir, mais c'est un bon moment pour faire le point. Ci-dessous figurent les licences déclarées dans le registre npm pour les paquets SDK respectifs, vérifiées le même jour.

ProjetPaquet SDKVersionChamp license de npm
Hexclave@hexclave/next1.0.102aucun champ
Better Authbetter-auth1.7.1MIT
Clerk@clerk/nextjs7.8.0MIT
SuperTokenssupertokens-node24.0.3Apache-2.0
WorkOS@workos-inc/node10.10.0MIT
Auth0@auth0/nextjs-auth04.27.0MIT
Kinde@kinde-oss/kinde-auth-nextjs2.13.1MIT

Si tu restes avec le projet, passe à @hexclave/* et traite-le comme une seule vraie migration au lieu de deux. Si tu veux quelque chose qui garde les données dans ta propre base et ne demande aucun compte chez un éditeur, Better Auth est le choix le plus proche, car c'est une bibliothèque plutôt qu'un service. Si tu préfères la même approche mais avec un serveur auto-hébergeable et un moteur séparé, regarde SuperTokens, en gardant à l'esprit les nuances de licence traitées dans cet article. Si tu acceptes un service fermé en échange de composants prêts à l'emploi et d'un déploiement rapide, le point de référence naturel est Clerk, et pour des exigences d'entreprise comme SAML et la synchronisation d'annuaire, WorkOS. Auth0 reste le choix des organisations qui ont besoin d'un éditeur mûr avec un long historique, tandis que Kinde se situe quelque part entre Clerk et un plan de départ bon marché. Quel que soit ton choix, l'intégration avec Next.js se ressemble globalement chez tous aujourd'hui, donc le coût du changement est surtout la migration des données plutôt que la réécriture des vues.

L'éditeur annonce l'import d'utilisateurs depuis Clerk, Auth0, Firebase Auth et Supabase Auth sans imposer de réinitialisation de mot de passe. C'est une information sur le trafic vers Hexclave, pas en sens inverse.

Erreurs fréquentes

Remplacer @stackframe/stack par @hexclave/js au lieu de @hexclave/next est le faux pas le plus fréquent, car les noms suggèrent autre chose que ce que dit le tableau de correspondance. Le paquet js est la variante indépendante du framework.

Installer le paquet nu hexclave te donne une coquille de 660 octets qui sort avec un code d'erreur quand on l'exécute. Le vrai outil est @hexclave/cli.

Changer les imports sans corriger l'émetteur dans la vérification des JWT compile très bien et s'effondre en production, au premier token signé sous le nouveau domaine.

Supposer que les passkeys suivent avec tout le reste est faux. Les clés enregistrées sur .built-with-stack-auth.com ne fonctionnent pas sur .built-with-hexclave.com, car le standard les lie au domaine.

Noter la licence comme « MIT » d'après le seul champ npm ne marche pas, car le champ n'existe pas. Noter « AGPL » pour l'ensemble est inexact aussi, puisqu'elle s'applique au côté serveur. La bonne entrée est une double licence avec une séparation client et serveur.

Laisser des liens stack-auth.com dans la documentation de ton projet fonctionne techniquement grâce aux redirections, mais un nouveau membre de l'équipe atterrira sur une page avec un autre nom et perdra un quart d'heure à établir si c'est bien la même chose.

FAQ

Stack Auth a-t-il cessé d'exister ?

Non. Le nom a changé ; le code et le service continuent sous la marque Hexclave. Le dépôt hexclave/hexclave compte 6842 étoiles, n'est pas archivé et livre de nouvelles versions tous les quelques jours. Le nom a disparu, pas le projet.

Mon appli sur @stackframe/stack va-t-elle cesser de fonctionner ?

Pas à une date prévisible. La documentation de migration indique que les deux adresses d'API pointent vers le même service et que rester sur l'ancien SDK n'exige aucune action. Cela dit, l'ancien paquet n'a eu aucune version depuis le 26 mai 2026 et il n'y a aucune déclaration sur les correctifs de sécurité.

Quelle quantité de travail représente la migration ?

Pour un projet Next.js typique, c'est un échange de dépendance, le remplacement du préfixe Stack par Hexclave dans les imports, et une correction de l'émetteur JWT si tu vérifies toi-même les tokens. Les anciens noms de classes restent comme alias, donc le renommage est facultatif. La nouvelle inscription des passkeys est à traiter séparément.

Quelle est la licence d'Hexclave ?

Double, selon la partie. Le code client et les exemples sous MIT, les composants serveur, backend et dashboard compris, sous AGPLv3. La plupart des paquets n'ont aucun champ license dans le registre npm, donc les outils d'audit les signaleront comme inconnus même si le fichier MIT se trouve à l'intérieur de chaque tarball.

En quoi Hexclave diffère-t-il de l'ancien Stack Auth côté produit ?

Le périmètre est plus large. Au-delà de l'authentification, des équipes et des rôles, il ajoute les paiements, les e-mails, un coffre pour les données sensibles, les webhooks, l'analytique, les clickmaps et les replays de session. Certaines de ces dépendances étaient déjà présentes dans la dernière version sous l'ancien nom.

L'éditeur a-t-il annoncé le renommage ?

Je n'ai trouvé aucune annonce de ce genre. Le blog n'a aucun article sur le sujet, et le plus ancien article de 2024 a été réécrit à la nouvelle marque sans note. Le seul endroit qui décrit le changement est la page de migration de la documentation.

À lire aussi