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. The Publishable key is a core authentication requirement for running the other Authentication contexts. Provide the Publishable key for your Supabase.

    • Publishable (anon) key - Gives you basic anon access to run tests under the anon context in your the Supabase instance (sb_publishable_...).

  2. 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.

  3. 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 (Hosted Only, not supported for Self Hosted).

  4. Optional credentials unlock additional authentication contexts:

    • 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 stored on your machine in an encrypted format.