Troubleshooting

​

Authentication Issues

​

GitHub OAuth sign-in fails

1. Verify GitHub OAuth is enabled in Supabase → Authentication → Providers → GitHub
2. Check the OAuth callback URL matches: https://your-project.supabase.co/auth/v1/callback
3. Confirm .env.local has correct VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY

​

Session expires unexpectedly

• Check that your browser isn’t blocking third-party cookies
• Clear local storage for the playground domain and sign in again

​

Organization memberships not syncing

• Ensure the OAuth app requests the read:org scope
• Verify your GitHub org allows OAuth app access
• Sign out and sign back in to force a sync

​

Supabase Connection Issues

​

”Failed to connect to Supabase”

1. Check if your Supabase project is paused (free tier pauses after 7 days of inactivity)
2. Verify environment variables are correct
3. Test directly: curl https://your-project.supabase.co/rest/v1/ -H "apikey: your-anon-key"

​

Preventing project pausing

name: Keep Supabase Active
on:
  schedule:
    - cron: '0 0 */3 * *'
jobs:
  ping:
    runs-on: ubuntu-latest
    steps:
      - run: curl -s "${{ secrets.SUPABASE_URL }}/rest/v1/" -H "apikey:${{ secrets.SUPABASE_ANON_KEY }}"

​

Row Level Security (RLS) Errors

​

”new row violates row-level security policy”

1. Verify you’re authenticated — sign out and sign back in
2. Check your workspace membership and role in Supabase → workspace_members table
3. Viewers cannot create/edit policies; Editors can create/edit but not manage members

​

”permission denied for table”

• Ensure RLS is enabled on all tables
• The audit_log table is append-only — update/delete operations are blocked by design

​

Policy Editor Issues

​

Monaco Editor not loading

1. Hard refresh: Ctrl+Shift+R / Cmd+Shift+R
2. Check browser console for JavaScript errors (Monaco requires WebAssembly)
3. Ensure browser is up to date (Chrome 90+, Firefox 90+, Safari 15+)
4. Disable content-modifying browser extensions

​

”Policy name already exists”

​

Governance Workflow Issues

​

Can’t edit an Approved/Production policy

​

Emergency bypass not available

• Must be enabled in Workspace Settings → Governance
• Only workspace Owners can perform emergency bypasses

​

Free Tier Limitations

​

Supabase

​

Vercel

​

GitHub Actions

​

Error Message Reference

​

Support Resources

• Getting Started — Initial setup
• Governance Workflow — Approval processes
• Compliance Mapping — Framework mapping
• Audit Trail — Logging and export
• CI/CD Integration — GitHub Actions workflows
• RBAC Simulator — Role-based testing
• Policy Templates — Template documentation
• Supabase Documentation
• Vercel Documentation
• GitHub Actions Documentation