Docs Set up your stack
Set up Relia in a Supabase app
Watch a Supabase app in three parts: the web app's table reads and writes, your Edge Functions, and the database's own statistics.
Many Supabase apps talk to the database straight from the browser, with no server of their own. Relia sees those calls too. This page sets up three parts; do the ones your app has. To have your AI assistant do it instead, see Set up Relia with your AI assistant.
Before you start
- A Relia account (Create your account).
- Your project's id and key, for the Edge Functions part. In Relia, open your project, click Setup Guide & SDK and pick Supabase: the steps there have your values filled in.
Steps
Part 1: the web app
In your web app's folder, run:
npx relia-sdk@latest initSign in, choose Everything Relia found here, pick your project and answer the two questions. The full walkthrough is in Watch your web app.
That's all supabase-js needs. Relia recognizes its calls by itself:
- Every table read and write appears on the Database page: the table, the operation, and the filters without their values.
?email=eq.ann@shop.iois stored asWHERE email = ?, and the query string never leaves the browser. - A write refused by a row level security policy is named as such, not just shown as a 403.
- Sign-ins and sign-ups are counted by outcome.
- Storage uploads and Edge Function calls show as calls to Supabase.
Your Supabase anon key is never stored.
Part 2: Edge Functions
Wrap each function's handler in
supabase/functions/<name>/index.ts. The handler itself stays unchanged:import { withRelia } from "npm:relia-sdk/edge" Deno.serve(withRelia(async (req) => { // your handler, unchanged }))Give the functions their settings once (the same for every function):
supabase secrets set RELIA_PROJECT_ID=<your project id> RELIA_KEY=<your project key> RELIA_SERVICE_NAME=shop-functionsTesting locally with
supabase functions serve? The local server stops a function right after it answers, which cuts off sending. Add the settings tosupabase/functions/.env, plus two more lines:RELIA_PROJECT_ID=<your project id> RELIA_KEY=<your project key> RELIA_SERVICE_NAME=shop-functions RELIA_ENV=development RELIA_FLUSH=beforeMake sure
.gitignorecoverssupabase/functions/.env.
Each call becomes a request named after the function, its supabase-js table calls become database calls, and its fetch calls become outgoing calls. In production the data is sent after the response, so your users never wait for it.
Tip: the same wrapper works on Cloudflare Workers, Vercel Edge and Deno. See Set up edge runtimes.
Part 3: inside your database (optional)
Relia can also read your database's own statistics:
- slow queries as Postgres measures them, including ones no app call shows, like those from scheduled jobs;
- scheduled jobs (pg_cron) that fail, and jobs that stop running;
- connections running out, and the database's size.
- In Relia, open Database and click Connect.
- Copy the SQL snippet Relia shows and run it once in Supabase's SQL editor. It creates a login called
relia_monitorthat can read statistics only and can't see or change your data. The password is made for you and shown only there. No pg_cron? Skip the snippet's last two lines. - In Supabase, open Connect and copy the Session pooler connection string, with the user
relia_monitorand the password from the snippet. - Paste it into Relia and click Connect.
Relia refuses any login that can read your tables, stores the connection string encrypted, and reads every 5 minutes. If your database has network restrictions on, allow Relia's server first.
Tip: watch Database monitoring for Postgres, MongoDB and Supabase (2 min).
Linking the web app to a function (optional)
To see a browser call and the function it reached as one story, do both:
- add
propagateTo: ["*.supabase.co"]toRelia.init; - add
traceparentto the function'sAccess-Control-Allow-Headers.
Do both or neither: without the CORS change, the browser refuses the call.
Check it worked
Open your web app once, and call a function if you set those up. On your project's Setup tab, Visits to your web app changes from Not yet to Arriving, and Requests from your server too once a function has been called. Your table reads and writes appear under Database.
If something's wrong
- Function calls never arrive when testing locally: add
RELIA_FLUSH=beforetosupabase/functions/.env. - Connect refuses the login: use the
relia_monitorlogin from the snippet, not your admin password. Relia refuses any login that can read or change your tables. - No table calls on Database: make sure the web app part is set up and you've used the app once. See Relia shows no data.
Next
Last checked against the product: 1 Nov 2026