pg-toolbelt

Monorepo for Supabase PostgreSQL tooling.

Packages

Package	Description	npm
@supabase/pg-delta	PostgreSQL schema diff and migration tool
@supabase/pg-topo	Topological sorting for SQL DDL statements

Development

Prerequisites

• Bun (latest)
• Docker (for integration tests)
• Node.js >= 20 (for TypeScript compilation)

Setup

bun install

Commands

bun run build           # Build all packages
bun run test            # Test all packages
bun run test:pg-delta   # Test pg-delta only
bun run test:pg-topo    # Test pg-topo only
bun run check-types     # Type check all packages
bun run format-and-lint # Format and lint all code

Working with individual packages

# pg-delta
cd packages/pg-delta
bun run test src/       # Unit tests only
bun run test tests/     # Integration tests only (requires Docker)

# pg-topo
cd packages/pg-topo
bun run test            # All tests (requires Docker)

Releasing

This monorepo uses changesets for versioning.

bunx changeset          # Create a changeset
bun run version         # Apply changesets to update versions
bunx changeset publish  # Publish to npm

Contributing

See CONTRIBUTING.md before opening a pull request.

• Open an issue first.
• Wait for maintainer triage via one of ✨ Feature, 🐛 Bug, 📘 Docs, or 🛠️ Chore.
• Then open a pull request.

Use ISSUES.md for issue-writing guidance, especially for pg-delta reproductions.

License

MIT