Skip to main content

Getting Started

Installation​

Download and install the Supatester desktop application for your platform. On first launch, you will be taken to the Connections page to add your first Supabase project.

What You Need​

To connect to a Supabase project you need, at minimum:

  • Your project's Supabase URL (e.g. https://your-project.supabase.co)

Credentials / Keys​

  1. In order to unlock the Schema Explorer and auto fill many of the text fields within Supatester, you will need to enter your Service Key (sb_secret_...).

    • Service Role (secret) key — Required for filling the Schema section. Can be selected as the authentication type when running tests.

  2. If you are testing Edge Functions, then it is recommended that you add your Supabase Management Token to Supatester. This will allow for the app to test Edge Functions within the app:

    • Management API token — for accessing information about Edge Functions (Online Only).

  3. Optional credentials unlock additional authentication contexts:

    • Publishable (anon) key - Gives you basic anon access to run tests under the anon context in your the Supabase instance (sb_publishable_...).
    • Email and password — for testing as a signed-in user (e.g. test@test.com / P@ssw0rd).
    • Anonymous Sign-in — Supabase Anonymous sign-in. Supported with and without Cloudflare Turnstile.
    • Custom Token — For forging custom JWT tokens for in depth testing of claims, etc.
    • Cloudflare Turnstile site key — if your project requires Turnstile CAPTCHA for anonymous sign-in.

Note: All credentials are encrypted using your operating system's secure storage. They are never stored as plain text on disk and are never sent to the cloud.