Authentication

Hyperlaunch's authentication system is built on Auth.js, providing a robust and secure authentication solution.

This guide walks you through implementing Google authentication, though the process is similar for other providers. By default, Hyperlaunch includes both Google authentication and Magic Link login (powered by Resend, covered in the email setup section).

Google Authentication Setup

Add the following environment variables to your .env.local file:

GOOGLE_ID=[your-client-id]
GOOGLE_SECRET=[your-client-secret]

Step 1: Google Cloud Console Configuration

Navigate to the Google Cloud Console and complete these steps:

1. Access "APIs & Services" > "Credentials"
2. Select "Configure Consent Screen"
3. Complete the OAuth consent form configuration
4. Configure the required OAuth scopes:
   • email
   • profile
5. Add test users for development purposes

Step 2: OAuth Credentials Configuration

Create your OAuth 2.0 credentials with these settings:

1. Select "Web Application" as the application type
2. Configure authorized origins:

http://localhost:3000

https://[your-domain].com

3. Configure authorized redirect URIs:

http://localhost:3000/api/auth/callback/google
https://[your-domain].com/api/auth/callback/google

Step 3: Production Deployment

Before going live, complete these verification steps:

1. Submit your application for verification in the OAuth Consent Screen
2. Verify domain ownership through Google Search Console
3. Monitor your email for verification confirmation from Google

Note: During the verification process, authentication will remain functional, though users may encounter standard security notices.

With that done you can go to the next section (test-your-app) to start running your app.