Terminal
Terminal/Skill
Guides adding Descope login to an app, covering passwordless sign-in, OAuth, SSO and MFA, with steps for each framework.
By Descope
Works with
npx skills add descope/skills --skill descope-authIntegrate secure, passwordless authentication using Descope Flows and SDKs.
Detect the user's framework and use the appropriate reference:
| If project has... | Use reference |
|---|---|
next in package.json | references/nextjs.md |
react (no Next.js) | references/react.md |
@angular/core in package.json | references/angular.md |
| No frontend framework (plain HTML/JS) | references/vanilla-js.md |
| Python/Node.js backend only | references/backend.md |
NEXT_PUBLIC_DESCOPE_PROJECT_ID=<your-id><Descope> component renders the login form. Check the browser console — a missing or invalid Project ID produces a clear Could not load flows error.// src/app/login/page.tsx
import { Descope } from '@descope/nextjs-sdk';
export default function LoginPage() {
return (
<Descope
flowId="sign-up-or-in"
onSuccess={(e) => console.log('Authenticated:', e.detail.user)}
onError={(e) => console.error('Auth failed:', e.detail)}
/>
);
}
For React SPA or backend-only setups, see the framework-specific references below.
| Flow ID | Purpose |
|---|---|
sign-up-or-in | Combined signup/login (RECOMMENDED) |
sign-up | Registration only |
sign-in | Login only |
step-up | MFA step-up authentication |
update-user | Profile updates, add auth methods |
| Method | When to use |
|---|---|
| OTP (Email/SMS) | Quick verification codes |
| Magic Link | Passwordless email links |
| Passkeys | Biometric/WebAuthn (most secure) |
| OAuth | Social login (Google, GitHub, etc.) |
| SSO | Enterprise SAML/OIDC |
| Passwords | Traditional auth (not recommended) |
validateSession()references/nextjs.md - Next.js App Router & Pages Router integrationreferences/react.md - React SPA integrationreferences/angular.md - Angular integrationreferences/vanilla-js.md - Vanilla JavaScript / plain HTML integrationreferences/backend.md - Backend session validation