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).
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 with live introspection.
- Build queries visually — construct SELECT, INSERT, UPDATE, and DELETE queries through a form, or use the advanced chain builder for full control.
- 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 |