Plugins

Rocketship provides a plugin-based architecture for testing different protocols and services. Each plugin is designed to be simple, focused, and composable.

Available Plugins

API Testing

HTTP - Test REST APIs with request chaining, assertions, and OpenAPI validation
Supabase - Test Supabase database, authentication, and storage operations

Database Testing

SQL - Execute queries and validate results across PostgreSQL, MySQL, SQLite, and SQL Server

Browser Testing

Agent - AI-powered testing using Claude with MCP servers (recommended)
Playwright - Deterministic browser automation with Python scripts
Browser Use - AI-driven browser automation with natural language tasks

Scripting & Utilities

Script - Execute custom JavaScript or shell scripts for data processing and validation
Log - Output custom messages during test execution
Delay - Add deterministic pauses between test steps

Plugin Architecture

All plugins follow a consistent interface:

- name: "Step name"
  plugin: plugin_name
  config:
    # Plugin-specific configuration
  assertions:
    # Optional validation
  save:
    # Optional variable extraction
  retry:
    # Optional retry policy

Common Features

All plugins support:

Variables: Use {{ .env.VAR }}, {{ .vars.name }}, and {{ runtime_var }}
Assertions: Validate responses and outputs
Save: Extract values for use in later steps
Retry: Configure automatic retries with backoff

Plugin Selection Guide

Use Case	Recommended Plugin	Alternative
REST API testing	HTTP	-
Database CRUD	SQL	Supabase
Supabase full-stack	Supabase	SQL + HTTP
AI browser testing	Agent	Browser Use
Deterministic browser	Playwright	-
Data processing	Script	-
Debugging/logging	Log	-
Timing control	Delay	Retry policies