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 (Note: Edge Function discovery is not supported with Self-Hosted supabase).
- 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.
Licensing
The application offers both Free and Pro tiers. The Free tier provides access to building and testing queries, while the Pro tier unlocks more advanced testing capabilities. The details are as follows:
Free:
- Connections
- Schema Explorer
- Query Builder
- RPC Tester
- Bucket Browser
- Bucket Tester
- Edge Functions
- Publishable & Secret Authentication Contexts
Pro:
- Everything in Free
- Collections
- Automated Testing
- Rate Limit Tester
- Email / Anon / JWT Authentication Contexts
- Test Plan Generation
- Snapshots & Reports
- Supatester-cli for CI/CD workflows
Note: The application needs access to the Internet to validate the license key against the server. You will need to at least give the application access to the internet once a month in order for the license to be validated.
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 |