Skip to content
Unbondr Docs
Documentation / Supabase

SUPABASE

Publish, write data and diagnose requests.

Trace published reads, configure credentials and isolate errors in the application, hosting layer or database.

Configure the generated application

Use an application export or Vercel Publish when the site needs database routes. React exports generate Next.js routes and Vue exports generate Nuxt routes. HTML application exports use Vercel Functions; use vercel dev when testing those functions locally.

Vercel Publish provisions the database connection environment for the deployment. For a downloaded application or GitHub deployment, read unbondr.database.json and set the corresponding UNBONDR_DB_<UUID_WITHOUT_HYPHENS_UPPERCASE> server environment variable before running the app. Its JSON value has the shape below.

Server environment value · replace the placeholders
{"provider":"supabase","url":"https://PROJECT_REF.supabase.co","key":"sb_publishable_REPLACE_ME"}

Map a write or a private upload

OperationBuilder mappingSupabase requirement
InsertMap a form ID and writable columns. Input names must match the configured column names.Grant INSERT and define the applicable RLS policy. An owner column is populated from the verified visitor.
Update or deleteMap the primary-key field for one target record. Allow only the columns the visitor should submit.Grant the required operation and define ownership policies. Test with a signed-in account and records it owns.
UploadMap a form with an input named file and type=file, and select the bucket.Use a private bucket with user-folder policies. The runtime accepts PNG, JPEG, WebP and PDF up to 5 MB and emits unbondr:upload-complete with the resulting path.
CheckoutUse the commerce SQL and map the checkout form for the catalog.The order operation checks stock and records an unpaid order. Payment collection requires a separate integration.

Read the browser Network panel

ObservationInterpretation and next check
GET /api/unbondr-data?configuration=1This same-origin request initializes browser configuration. For a table source named posts, look separately for GET /api/unbondr-data?source=posts. An authentication-only source has no table read.
307 followed by vercel.com/sso-api or /loginVercel Deployment Protection is requesting a Vercel session. Open the deployment with authorized access or test its intended public production URL, then inspect the application endpoint again.
A successful read returns []Check that the table contains matching rows, that the source filter matches them and that the current visitor’s SELECT policy permits them. Test the published page using the intended visitor account.
The response contains rows but one card stays emptyInspect Collection on the repeated card and item.* bindings on its children. Compare the exact column names and types with the JSON response. An image expects a usable URL.
Authentication page no longer existsOpen the named source and replace the stale route with a current page. Save the source and publish again.
Reset email arrives, but the form never opensCheck the returned hostname and path, the Supabase redirect allowlist, the mapped new-password form and the requesting browser profile.