Netlify Identity
Netlify Identity is a user management service for signups, logins, password recovery, user metadata, and role-based access control. It is built on
GoTrue
and issues JSON Web Tokens (JWTs).
Always use
@netlify/identity
.
Never use
netlify-identity-widget
or
gotrue-js
— they are deprecated.
@netlify/identity
provides a unified, headless TypeScript API that works in both browser and server contexts (Netlify Functions, Edge Functions, SSR frameworks).
Dashboard configuration (user handoff required)
All Identity instance configuration is dashboard-only — there is no public API.
The agent owns the code, deploys, and the handoff checklist; the user owns flipping dashboard settings. Outside of a Netlify Agent Runner deploy, the Identity instance must be enabled in the dashboard before any auth flow will work. If you write Identity code first and only discover this when
/.netlify/identity/signup
404s after a production deploy, that's wasted work — surface the dashboard handoff up front instead.
Dashboard URL pattern:
https://app.netlify.com/projects/
netlify-identity
安装
npx skills add https://github.com/netlify/context-and-tools --skill netlify-identity