Get Nube Auth integrated into your application quickly.

Install the SDK

npm install @nube-auth/sdk
# or
pnpm add @nube-auth/sdk
# or
yarn add @nube-auth/sdk

Initialize the Client

import { NubeAuthClient } from '@nube-auth/sdk';

const nubeAuth = new NubeAuthClient({
  appId: 'your-app-id',
  apiUrl: 'https://api.nubeauth.com' // or your self-hosted URL
});

Add Authentication

// Start OAuth login
async function handleLogin() {
  await nubeAuth.login({ provider: 'google' });
}

// Handle callback (in your callback page)
async function handleCallback() {
  const result = await nube-auth.handleCallback();
  if (result.success) {
    // User is now authenticated
    const user = await nubeAuth.getUser();
    console.log('Welcome', user.name);
  }
}

// Logout
async function handleLogout() {
  await nubeAuth.logout();
}

Check Authentication Status

// Get current user (returns null if not authenticated)
const user = await nubeAuth.getUser();

if (user) {
  console.log('Logged in as:', user.email);
} else {
  console.log('Not authenticated');
}

Protect Routes

// React example
function ProtectedRoute({ children }) {
  const { user, loading } = useNube Auth();
  
  if (loading) return <Loading />;
  if (!user) return <Navigate to="/login" />;
  
  return children;
}

Next Steps

• Installation - Detailed setup guide
• Configuration - Environment and options
• OAuth Providers - Configure providers