Skip to main content

supabase-common

Tree-shakeable TypeScript helpers for Supabase — dependency-free core, optional client factories.

import { unwrap } from '@rtorcato/supabase-common'

// Throws SupabaseError on error, returns the row otherwise.
const user = unwrap(await supabase.from('users').select().single())
npm install @rtorcato/supabase-common

Use with AI

A skill ships with the package so coding agents use supabase-common correctly — whichever tool you're in.

Read the rules →
Any coding agent
Pull the skill into any tool the skills CLI supports.
npx skills add https://github.com/rtorcato/supabase-common --skill supabase-common
Claude Code
The repo is its own plugin marketplace — add it, then install the skill.
/plugin marketplace add rtorcato/supabase-common
/plugin install supabase-common@supabase-common
Cursor, Copilot, Codex
They read AGENTS.md. It ships in the npm tarball, so it is already in your node_modules.
node_modules/@rtorcato/supabase-common/AGENTS.md

Sibling projects

More from @rtorcato — same conventions, same release pipeline.