@oneuid/login

@oneuid/login

Drop-in login component for OneUID. Renders the right UI from your app’s enabled auth methods: email/password, OAuth (Google, GitHub, Apple), and phone OTP.

Install

npm install @oneuid/login
# or
pnpm add @oneuid/login
# or
yarn add @oneuid/login

Peer dependencies: React 18+ (and react-dom).

Usage

import { LoginBox } from '@oneuid/login';

<LoginBox
  clientId="clxx..."
  apiUrl="https://api.oneuid.dev"
  onSuccess={(data) => {
    console.log(data.accessToken, data.refreshToken);
    // Store tokens and redirect or update app state
  }}
  onError={(msg) => console.error(msg)}
/>

Props

Prop	Type	Required	Description
clientId	string	Yes	Your OneUID app client ID (from the dashboard).
apiUrl	string	Yes	OneUID API base URL (e.g. https://api.oneuid.dev).
onSuccess	(data: LoginSuccessData) => void	Yes	Called with { accessToken, refreshToken, expiresIn, user } after a successful login.
onError	(error: string) => void	No	Called when loading auth methods or login fails.
redirectUrl	string	No	OAuth callback URL (defaults to current window location).
className	string	No	Extra CSS class for the container.
brandName	string	No	App name shown in the title (otherwise from API).
logoUrl	string	No	URL of your logo image.

The component fetches enabled auth methods from GET /v1/public/auth-methods?clientId=... and shows the matching options (social buttons, email/password form, or phone OTP flow).

Important links

• OneUID (marketing, get started) — https://oneuid.dev
• API reference (all endpoints) — https://oneuid.dev/docs
• Dashboard — https://dashboard.oneuid.dev
• API base URL — https://api.oneuid.dev
• Postman — Download the collection from the dashboard; it matches the API docs.

License

MIT