Login & Authentication Issues

Introduction

NoteWave uses secure Google OAuth authentication powered by NextAuth.js and Supabase. If you're experiencing login problems, this guide will help you diagnose and resolve authentication issues.

Common Login Problems

Most authentication issues fall into these categories:

OAuth Errors

Google OAuth callback fails or returns an error during sign-in.

Session Expired

Your session has timed out and requires re-authentication.

Browser Issues

Cookies disabled, incognito mode, or browser extensions blocking login.

Google OAuth Errors

If you see an error during Google sign-in, try these solutions:

Troubleshooting steps:

Clear your browser cache and cookies
Disable browser extensions (especially ad blockers)
Try a different browser or incognito/private window
Ensure pop-ups are allowed for notewave.co.za
Check that third-party cookies are enabled

Corporate Networks

Some corporate firewalls block OAuth authentication. If you're on a company network, contact your IT department to whitelist notewave.co.za and Google OAuth domains.

Session Timeout & Refresh

NoteWave uses JWT-based sessions that automatically refresh to keep you logged in.

Automatic Refresh

Sessions auto-refresh with a 5-minute buffer before expiry to prevent interruptions.

Cross-Tab Sync

Multiple browser tabs synchronize to prevent duplicate refresh attempts.

If you see "Session expired," simply click the login button again. Your data is saved and you'll return to where you left off.

Browser Compatibility

NoteWave works best on modern browsers with cookies and JavaScript enabled.

Recommended browsers:

Google Chrome - Version 90 or newer
Microsoft Edge - Version 90 or newer
Safari - Version 14 or newer
Firefox - Version 88 or newer

Enable Cookies

Authentication requires cookies to be enabled. Check your browser settings under Privacy & Security to allow cookies from notewave.co.za.

Account Access Issues

If you can't access your account or see unexpected behavior:

Common scenarios:

Wrong Google account - Ensure you're signing in with the email address you used to register
Multiple accounts - Sign out of all Google accounts, then sign in with the correct one
Account suspended - Contact support if you believe your account was suspended in error
Email changed - If you changed your Google email, contact support to migrate your account

GitHub Authentication

NoteWave also supports GitHub OAuth as an alternative login method.

Switching Auth Providers

If you created your account with Google but want to use GitHub (or vice versa), contact support to link your accounts. Both providers must use the same email address.

Security Best Practices

Keep your account secure with these recommendations:

Use a strong, unique password for your Google or GitHub account
Enable two-factor authentication (2FA) on your OAuth provider
Never share your login credentials with anyone
Log out when using shared or public computers
Review connected apps in your Google account settings periodically

Still Can't Log In?

If you've tried all troubleshooting steps and still can't access your account:

Contact Support

Email us at contact@blazesolutions.ai with: (1) The email address you're trying to log in with, (2) The browser and operating system you're using, (3) Any error messages you see, (4) Screenshot of the error (if possible).

Support hours: Monday-Friday, 9:00 AM - 5:00 PM SAST (GMT+2)