React hooks and components for [Alien SSO](https://alien.org) authentication. Built on top of [@alien_org/sso-sdk-core](https://www.npmjs.com/package/@alien_org/sso-sdk-core).
npm install @alien_org/sso-sdk-reactReact hooks and components for Alien SSO authentication. Built on top of @alien_org/sso-sdk-core.
This is an early alpha version. The SDK is under active development and may contain bugs or undergo breaking changes. Use with caution in production environments.
``bash`
npm install @alien_org/sso-sdk-react
- ✅ React 19 support with modern hooks
- ✅ Pre-built components - Sign-in button and modal
- ✅ React Query integration for state management
- ✅ TypeScript-first with full type safety
- ✅ QR code generation with mobile deep link support
- ✅ Animated UI via Framer Motion
- ✅ Responsive design out of the box
📚 Full documentation at dev.alien.org/docs
- React Integration Guide - Complete integration walkthrough
- API Reference - Detailed API documentation
- Demo App - Example React application
For vanilla JavaScript/TypeScript usage or custom implementations, see @alien_org/sso-sdk-core.
The SDK handles the complete flow automatically:
1. User clicks Sign In button
2. Modal opens with QR code and deep link
3. User scans QR or opens deep link in Alien App
4. SDK polls for authentication completion
5. On success, exchanges code for access token
6. Auth state updates, modal closes
The SDK includes default styles, but you can customize them:
`tsx
import '@alien_org/sso-sdk-react/dist/style.css'; // Optional: Import default styles
// Override with your own CSS
.alien-sso-button {
background: your-color;
/ ... /
}
`
Includes full TypeScript declarations:
`typescript`
import type {
AlienSsoClientConfig,
AuthState,
TokenInfo
} from '@alien_org/sso-sdk-react';
- react ^19.1.1react-dom` ^19.1.1
-
Register your application at the Developer Portal to get your provider credentials.
- Modern browsers with ES2020+ support
- Chrome, Firefox, Safari, Edge (latest versions)
MIT