Demo App

Explore a complete working example of Alien SSO integration in a React application.

Live Demo

Try the demo app to see how Alien SSO works in practice:

View Demo App →

Repository

The complete source code is available in the sso-sdk-js monorepo:

Repository: github.com/alien-org/sso-sdk-js/apps/example-sso-app

Running Locally

Prerequisites

Node.js 18 or higher
npm or pnpm

Setup


# Clone the repository
git clone https://github.com/alien-org/sso-sdk-js.git
cd sso-sdk-js
 
# Install dependencies
npm install
 
# Build all packages (required before running demo)
npm run build
 
cd ./apps/example-sso-app/
 
# Copy .env.example and fill data
cp .env.example .env
 
# Run the example SSO app
npm run dev

The demo app will be available at http://localhost:3000 (or another port if 3000 is occupied).

Project Structure


apps/example-sso-app/
├── src/
│   ├── App.tsx              # Main application component
│   ├── main.tsx             # Entry point with AlienSsoProvider
│   ├── components/
│   │   ├── Dashboard.tsx    # Protected dashboard component
│   │   └── LoginPage.tsx    # Login page with SignInButton
│   └── ...
├── package.json
└── vite.config.ts

Next Steps

Core Integration Guide - For vanilla JavaScript/TypeScript projects.
React Integration Guide - For React applications.
API Reference - React - Complete API documentation for React SDK.