@alien_org/sso-sdk-react
v1.0.28
Published
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).
Readme
@alien_org/sso-sdk-react
React hooks and components for Alien SSO authentication. Built on top of @alien_org/sso-sdk-core.
⚠️ Alpha Version Notice
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.
Installation
npm install @alien_org/sso-sdk-reactFeatures
- ✅ 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
Documentation
📚 Full documentation at dev.alien.org/docs
- React Integration Guide - Complete integration walkthrough
- API Reference - Detailed API documentation
- Demo App - Example React application
Core SDK
For vanilla JavaScript/TypeScript usage or custom implementations, see @alien_org/sso-sdk-core.
Authentication Flow
The SDK handles the complete flow automatically:
- User clicks Sign In button
- Modal opens with QR code and deep link
- User scans QR or opens deep link in Alien app
- SDK polls for authentication completion
- On success, exchanges code for access token
- Auth state updates, modal closes
Custom Styling
The SDK includes default styles, but you can customize them:
import '@alien_org/sso-sdk-react/dist/style.css'; // Optional: Import default styles
// Override with your own CSS
.alien-sso-button {
background: your-color;
/* ... */
}TypeScript Support
Includes full TypeScript declarations:
import type {
AlienSsoClientConfig,
AuthState,
TokenInfo
} from '@alien_org/sso-sdk-react';Peer Dependencies
react^19.1.1react-dom^19.1.1
Getting a Provider Address
Register your application at the Developer Portal to get your provider credentials.
Browser Support
- Modern browsers with ES2020+ support
- Chrome, Firefox, Safari, Edge (latest versions)
License
MIT
