# supabase-tools

> Portable toolkit for local Supabase development

## Table of Contents

### Plugins

- [Plugins](/supabase-tools/plugins.md): List of available plugins, installation, and activation in supabase-tools.config.json.
- [@sbtools/plugin-db-test](/supabase-tools/plugins/plugin-db-test.md): Run database tests using pgTAP. Supports live PostgreSQL (Docker) or in-memory PGlite mode.
- [@sbtools/plugin-deno-functions](/supabase-tools/plugins/plugin-deno-functions.md): Document Supabase Edge Functions by statically analysing TypeScript source files.
- [@sbtools/plugin-depgraph](/supabase-tools/plugins/plugin-depgraph.md): Visualize backend dependency relationships as interactive HTML graph and Mermaid diagrams.
- [@sbtools/plugin-erd](/supabase-tools/plugins/plugin-erd.md): Generate Mermaid ERD diagrams for each public table. Connects to DB to introspect columns, keys, and relationships.
- [@sbtools/plugin-frontend-usage](/supabase-tools/plugins/plugin-frontend-usage.md): Scan frontend .ts/.tsx/.js/.jsx files for Supabase SDK usage and generate interactive HTML report.
- [@sbtools/plugin-logs](/supabase-tools/plugins/plugin-logs.md): Live Docker log tailing, pg_stat_statements query monitoring, and standalone HTML log viewer.
- [@sbtools/plugin-migration-audit](/supabase-tools/plugins/plugin-migration-audit.md): Compare migration files with database tracking. Read-only drift detection, CLI/JSON/HTML/Atlas reporting.
- [@sbtools/plugin-migration-studio](/supabase-tools/plugins/plugin-migration-studio.md): Flagship plugin — 21 tools, 4 workflows, intent graph, release gate, HTTP tool surface for AI agents.
- [Migration Studio Platform](/supabase-tools/plugins/plugin-migration-studio-platform.md): Full-stack backend design platform — understand, design, generate, validate, and apply schema changes with confidence.
- [Migration Studio Contributing](/supabase-tools/plugins/plugin-migration-studio-contributing.md): How to contribute new Migration Studio tools and workflows using the catalog-driven architecture.
- [@sbtools/mcp-server](/supabase-tools/plugins/plugin-mcp-server.md): MCP server for @sbtools/mcp-server — exposes all 21 studio tools and 3 resources over stdio for Claude Desktop, Cursor, and VS Code Copilot.
- [@sbtools/plugin-scaffold](/supabase-tools/plugins/plugin-scaffold.md): Scaffold new supabase-tools plugins with consistent boilerplate and SDK integration.
- [@sbtools/plugin-typegen](/supabase-tools/plugins/plugin-typegen.md): Generate TypeScript types from the running Supabase instance using the PostgREST types endpoint.

### Architecture

- [Architecture](/supabase-tools/architecture.md)
- [Package & Artifact Dependencies](/supabase-tools/architecture/package-dependencies.md)
- [Artifact ID Registry](/supabase-tools/architecture/artifact-registry.md)
- [Artifact Contract Authoring Guide](/supabase-tools/architecture/artifact-contract-guide.md)
- [Artifact Compatibility Policy](/supabase-tools/architecture/artifact-compatibility-policy.md)
- [Implicit File Contracts and Output Paths](/supabase-tools/architecture/implicit-file-contracts.md)

### Other

- [@sbtools/ui-web](/supabase-tools/ui-web.md): @sbtools/ui-web — Shared React UI package: SSR renderers for standalone HTML reports and the Vite React dashboard SPA.
- [CLI Reference](/supabase-tools/cli-reference.md): Complete command reference for sbt — core commands, plugin commands, flags, and environment variables.
- [Configuration](/supabase-tools/configuration.md): Full reference for supabase-tools.config.json — paths, db, api, plugins, and validation.
- [Getting Started](/supabase-tools/getting-started.md): Install @sbtools/core and plugins, create supabase-tools.config.json, and run your first commands.
- [Migration Studio Platform — Status & Roadmap to 100%](/supabase-tools/plans/platform-status-and-roadmap.md)
- [Plan: Extend Adoption Page Visualizations](/supabase-tools/plans/adoption-page-visualization-extensions.md)
- [Plan: Platform Catalog Completion and Expansion](/supabase-tools/plans/platform-catalog-completion-and-expansion.md)
- [SDK API Reference](/supabase-tools/sdk.md): SDK types, PluginContext, UI utilities, error classes, container/compose utils, and helpers for building plugins.
- [Version and Release Guide](/supabase-tools/publishing.md): How to publish @sbtools packages to npm using changesets and CI.
- [Writing Plugins](/supabase-tools/writing-plugins.md): Build custom supabase-tools plugins — from scaffold to publish.