Troubleshooting Supamode

Solutions to common Supamode issues including sign-in problems, missing tables, API errors, and deployment issues.

This section covers solutions to common issues you might encounter when setting up or using Supamode. For each problem, we provide the likely causes and step-by-step fixes.

Common Issues

IssueLikely CauseQuick Fix
Cannot sign inMissing admin access, wrong credentialsCheck user has Supamode account
Tables not showingTables not synced, missing permissionsRun sync_managed_tables()
API connection errorsWrong environment variablesVerify SUPABASE_URL and keys
"Unauthorized" errorsJWT expired or invalidRe-authenticate, check tokens
Slow performanceLarge datasets, missing indexesAdd filters, check DB indexes

Getting Help

If these guides don't resolve your issue:

  1. Check the console: Browser DevTools (F12) and server logs often reveal the root cause
  2. Search existing issues: The GitHub issues may have solutions
  3. Contact support: Reach out through your MakerKit account for direct assistance