Skip to content

Troubleshooting

Common issues and fixes for the Microlearning Platform.

Guides

Troubleshooting Guide

Common issues covering:

  • Local development issues
  • Authentication failures
  • Database connection issues
  • Deployment problems

Colima Fix

Docker on macOS issues with Colima.

Quick Fixes

Supabase Won't Start

# Stop all instances
supabase stop --all

# Clear Docker resources
docker system prune

# Restart
supabase start

Authentication Failures

# Verify Supabase is running
supabase status

# Check environment variables
cat .env.local

# Reset test users
deno task local:seed

Database Connection Issues

# Check database status
supabase status

# Reset database
supabase db reset

# View connection info
supabase db remote get

Edge Functions Not Responding

# Check function logs
supabase functions logs <function-name>

# Restart functions
supabase functions serve

CI/CD Failures

  1. Check GitHub Actions logs
  2. Verify secrets are set correctly
  3. Run tests locally: deno task test:e2e:all
  4. Check deployment status: deno task deploy:check