Supatester — User Documentation
Supatester is a desktop application for testing Supabase projects. It combines a visual query builder, multi-context authentication, automated test plans, rate limit testing, schema exploration, and a separate Node.js‑based CLI Test Plan runner published as an npm package (for use with Continuous Integration platforms). Supatester is supported for Hosted Supabase and Self-Hosted Supabase.
What You Can Do
Supatester brings together everything you need to test, audit, and debug your Supabase projects:
- Explore schemas — browse tables, functions, buckets, and edge functions (not supported with Self-Hosted supabase) with live introspection.
- Build queries visually — construct basic and advanced SQL queries, browse buckets, create bucket queries, execute RPC Functions and run Edge Functions.
- Test under any auth context — switch between anonymous user, email user, anon role, service role, and custom JWT contexts with a single click.
- Run automated test plans — turn saved requests into executable test suites with configurable pass/fail criteria.
- Rate Limit Test your database — Confirm that your rate limits work with various authentication contexts.
- Integrate with CI/CD — export test plans and run them from the command line (within CI tools such as GitHub Actions, Jenkins, etc.) with the Supatester CLI.
Documentation Sections
| Section | Description |
|---|---|
| Getting Started | Installation and initial setup |
| Connections | Managing Supabase project credentials |
| Authentication | Auth contexts and the custom JWT creator |
| Schema Explorer | Browsing tables, functions, buckets, and edge functions |
| Basic Query Builder | Visual database query construction |
| Advanced Query Builder | Full method chain control |
| RPC Tester | Invoking PostgreSQL functions |
| Bucket Browser | Visual file browser for Supabase Bucket Storage |
| Bucket Tester | Programmatic storage operations |
| Edge Function Tester | Invoking Supabase Edge Functions |
| Collections | Organising and managing saved requests |
| Automated Testing | Creating and running test plans |
| Rate Limit Testing | Performance benchmarking |
| Supatester CLI | Headless test runner for CI/CD |