Troubleshooting Guide¶
Solutions for common issues with Skigk Søkeapp.
Authentication Issues¶
Problem: OAuth Popup Closes Without Login¶
Symptoms: - Click "Logg inn med Google" - OAuth popup opens and closes - Not logged in
Solutions:
1. Check .env.local has correct VITE_GOOGLE_CLIENT_ID
2. Verify Client ID format: xxx.apps.googleusercontent.com
3. Check authorized redirect URIs in Google Cloud Console:
- Must include: http://localhost:4200 (dev) or https://skigk-soekeapp.web.app (prod)
4. Clear browser cookies and try again
5. Try in incognito window to rule out cache issues
Problem: "Access Denied" Error After Login¶
Symptoms: - User logs in successfully - Error message appears - Cannot use the app
Solutions:
1. Verify your Google Account is added to Shared Drives (if applicable)
2. Check Google Cloud Console scopes include:
- drive.readonly
- openid
- userinfo.profile
3. Try logout and login again
4. Check your Google Workspace admin hasn't restricted Drive API
Search Issues¶
Problem: Search Returns No Results¶
Symptoms: - Type keywords - No files appear - Blank result list
Solutions: 1. Check file exists in My Drive: - Go to https://drive.google.com - Search for the same filename - If it's not there, it won't appear in Skigk either
- For Shared Drives:
- Verify you are a member of the Shared Drive
- Ask a Shared Drive manager to add you
-
May take 24 hours for new memberships to reflect
-
Try broader search:
- Instead of "quarterly_report_2026_Q1_final_v3.xlsx"
-
Try just "quarterly" or "report"
-
Check file sharing:
- File owner must have shared the file with you or your group
- Files in Shared Drives you're a member of should be searchable
Problem: Search is Very Slow¶
Symptoms: - Typing takes a while - Results take 10+ seconds - Search hangs
Solutions: 1. Check network connection: - Slow internet will slow search - Try on a different network
- Reduce search scope:
- Search fewer Shared Drives
-
Use specific keywords instead of broad terms
-
Try another browser:
-
Rules out browser-specific issues
-
Check Google Drive quota:
- If you have thousands of files, search naturally takes longer
- Archive old files to speed up search
Problem: AI Summary Not Working¶
Symptoms: - Click "Get Summary" - Loading spinner - Error message or timeout
Solutions:
1. Check Gemini API key:
- Verify VITE_GEMINI_API_KEY is set in .env.local
- Key format should be alphanumeric string
- Check file type:
- Summaries work best with: Docs, Sheets, PDFs
-
Images, videos, archives may not work
-
Check file size:
- Very large files (>10MB) may timeout
-
Try with a smaller file first
-
Check API quota:
- Go to Google Cloud Console → APIs → Gemini API
- Verify quota hasn't been exceeded
- If using free tier, may have rate limits
Deployment Issues¶
Problem: Firebase Deployment Fails¶
Symptoms:
- npm run build succeeds
- firebase deploy fails
- Error message about authentication
Solutions: 1. Verify Firebase login:
firebase login --reauth
-
Check correct Firebase project:
firebase projects:list firebase use skigk-soekeapp -
Verify .firebaserc exists:
{ "projects": { "default": "skigk-soekeapp" } } -
Check build output:
- Verify
dist/folder was created - Should contain
index.htmland JS files
Problem: App Loads But Shows Blank Page¶
Symptoms: - Navigate to https://skigk-soekeapp.web.app - White/blank page - No errors in console
Solutions: 1. Check browser console (F12): - Look for JavaScript errors - Report them for debugging
-
Verify Firebase Hosting is enabled:
firebase hosting:sites:list -
Clear browser cache:
- Firefox: Ctrl+Shift+Del
-
Chrome: Ctrl+Shift+Delete
-
Check if build was successful:
- Run
npm run buildagain - Look for errors in output
Google Cloud Issues¶
Problem: "Invalid Client" OAuth Error¶
Symptoms: - OAuth redirect shows "invalid_client" - Error page in browser
Solutions:
1. Verify OAuth client ID format:
- Should be: numbers.apps.googleusercontent.com
- Not: appname or incomplete string
-
Check Client ID matches Google Cloud Console:
# In .env.local VITE_GOOGLE_CLIENT_ID=<copy exact ID from Console> -
Verify authorized origins:
- Go to Google Cloud Console → Credentials
- Click your OAuth 2.0 Client
- Check "Authorized JavaScript origins" includes:
http://localhost:4200(for development)https://skigk-soekeapp.web.app(for production)
Problem: "Insufficient Scopes" Error¶
Symptoms: - OAuth login shows error about permissions - Cannot access Google Drive data
Solutions:
1. Check scopes in Google Cloud Console:
- Go to APIs & Services → OAuth Consent Screen
- Verify "Scopes" includes:
- drive.readonly
- openid
- userinfo.profile
- Update scopes in code (if needed):
- Check
src/services/auth.service.ts -
Verify OAuth initialization includes correct scopes
-
Logout and login again:
- Sometimes scope changes require re-authentication
Getting Help¶
If none of these solutions work:
-
Check Firebase Logs:
firebase functions:log --lines 50 -
Check Google Cloud Logs:
- Go to Console → Logging → Logs
-
Search for
skigk-soekeapp -
Enable Debug Mode:
- Set
DEBUG=*environment variable -
Provides more detailed error messages
-
Contact Support:
- Email: admin-2025@skigk.no
- Include error message and steps to reproduce
Last Updated: January 2026 | Version: 1.0