Skip to content

Docs: self-host troubleshooting for missing tables / RLS / edge 404s #23

Description

@telivity-otaip

Why

Most “CareerOps is broken” reports from self-hosters are config: schema not applied, RLS denying the anon key, or edge functions not deployed. Today that knowledge is scattered across web/README.md, web/SCHEMA.md, and supabase/README.md.

Size

S — one focused troubleshooting doc.

Task

Add docs/TROUBLESHOOTING.md (or a section under web/README.md) covering:

  1. Blank / Configure wallconfig.js missing or still placeholder URL/key
  2. PostgREST / missing relation — forgot supabase/schema.sql or migrations
  3. Rows won’t save — RLS / wrong project / signed-out
  4. Search / match / rewrite fail — which edge functions are optional vs needed (web/README Edge functions table)
  5. Google OAuth “not enabled” — expected until provider is configured

Link web/SCHEMA.md, supabase/README.md, and the demo at careerops.telivity.app as a reference — not as a place to steal credentials.

Acceptance

  • Concrete symptoms → checks → fixes
  • Explicit: never commit web/config.js; never reuse Telivity demo keys
  • Linked from root README or docs/README.md
  • No secrets, no internal vault paths

Out of scope

Changing runtime error UX (nice follow-up issue if you want it).

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationgood first issueGood for newcomershelp wantedExtra attention is needed

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions