home / skills / jeremylongshore / claude-code-plugins-plus-skills / supabase-deploy-integration

supabase-deploy-integration skill

safe

/plugins/saas-packs/supabase-pack/skills/supabase-deploy-integration

This skill deploys Supabase-powered apps to Vercel, Fly.io, and Cloud Run, configuring secrets and pipelines for production.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill supabase-deploy-integration

Review the files below or copy the command above to add this skill to your agents.

Files (5)

SKILL.md

1.8 KB

---
name: supabase-deploy-integration
description: |
  Deploy Supabase integrations to Vercel, Fly.io, and Cloud Run platforms.
  Use when deploying Supabase-powered applications to production,
  configuring platform-specific secrets, or setting up deployment pipelines.
  Trigger with phrases like "deploy supabase", "supabase Vercel",
  "supabase production deploy", "supabase Cloud Run", "supabase Fly.io".
allowed-tools: Read, Write, Edit, Bash(vercel:*), Bash(fly:*), Bash(gcloud:*)
version: 1.0.0
license: MIT
author: Jeremy Longshore <[email protected]>
---

# Supabase Deploy Integration

## Prerequisites
- Supabase API keys for production environment
- Platform CLI installed (vercel, fly, or gcloud)
- Application code ready for deployment
- Environment variables documented

## Instructions

### Step 1: Choose Deployment Platform
Select the platform that best fits your infrastructure needs and follow the platform-specific guide below.

### Step 2: Configure Secrets
Store Supabase API keys securely using the platform's secrets management.

### Step 3: Deploy Application
Use the platform CLI to deploy your application with Supabase integration.

### Step 4: Verify Health
Test the health check endpoint to confirm Supabase connectivity.

## Output
- Application deployed to production
- Supabase secrets securely configured
- Health check endpoint functional
- Environment-specific configuration in place

## Error Handling

See `{baseDir}/references/errors.md` for comprehensive error handling.

## Examples

See `{baseDir}/references/examples.md` for detailed examples.

## Resources
- [Vercel Documentation](https://vercel.com/docs)
- [Fly.io Documentation](https://fly.io/docs)
- [Cloud Run Documentation](https://cloud.google.com/run/docs)
- [Supabase Deploy Guide](https://supabase.com/docs/deploy)

Overview

This skill deploys Supabase-powered applications to Vercel, Fly.io, and Cloud Run with platform-specific secret configuration and deployment steps. It streamlines moving a Supabase app from development to production by automating secret storage, CLI-based deployment, and health verification. The goal is a repeatable, secure production rollout with minimal manual steps.

How this skill works

The skill guides you to pick a target platform, then configures platform-managed secrets for Supabase API keys and environment variables. It issues the appropriate CLI commands (vercel, fly, or gcloud) to perform the deployment and runs a health check endpoint to verify Supabase connectivity. Deployment artifacts and environment-specific configuration are produced as outputs for monitoring and rollback.

When to use it

Deploy a Supabase-backed app to production on Vercel, Fly.io, or Cloud Run
Migrate an app from staging to production with proper secret handling
Set up automated deployment pipelines that require Supabase credentials
Configure platform-specific environment variables and secrets before release

Best practices

Document all required Supabase API keys and environment variables before starting
Use each platform’s secrets manager instead of embedding keys in source code
Run a local staging deploy and health check before production rollout
Add automated checks for the health endpoint in CI/CD to catch regressions
Rotate Supabase keys periodically and update secrets through the platform CLI

Example use cases

Deploy a Next.js app using Supabase auth and database to Vercel with encrypted secrets
Launch a backend API container on Cloud Run that connects to Supabase and exposes a health endpoint
Host a realtime Supabase-integrated service on Fly.io with regional deployment and secrets configured
Integrate deployment steps into a CI pipeline to automatically push changes to production after tests pass

FAQ

What prerequisites do I need before deploying?

You need Supabase production API keys, the target platform CLI installed (vercel, fly, or gcloud), and documented environment variables for your app.

How do I verify the deployment succeeded?

Run the application’s health check endpoint to confirm Supabase connectivity and verify secrets are accessible; also monitor platform logs for runtime errors.