Introduction
NoteWave uses secure OAuth and email 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:
Google, Apple, or Microsoft sign-in fails or returns an error during the callback.
Your session has timed out and requires re-authentication.
Cookies disabled, incognito mode, or browser extensions blocking login.
OAuth Errors
If you see an error during OAuth 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
Session Timeout & Refresh
NoteWave uses JWT-based sessions that automatically refresh to keep you logged in.
Sessions auto-refresh with a 5-minute buffer before expiry to prevent interruptions.
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
Account Access Issues
If you can't access your account or see unexpected behavior:
Common scenarios:
- Wrong OAuth account - Ensure you're signing in with the email address you used to register
- Multiple accounts - Sign out of the current provider account, then sign in with the correct one
- Account suspended - Contact support if you believe your account was suspended in error
- Email changed - If your provider email changed, contact support to migrate your account
OAuth Authentication
NoteWave supports Google, Apple, and Microsoft sign-in as secure alternatives to email and password login.
Switching Auth Providers
Security Best Practices
Keep your account secure with these recommendations:
- Use a strong, unique password for your OAuth provider 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 provider account settings periodically
Still Can't Log In?
If you've tried all troubleshooting steps and still can't access your account:
Contact Support
Support hours: Monday-Friday, 9:00 AM - 5:00 PM SAST (GMT+2)
Was this article helpful?
Your feedback helps us improve our documentation.
