Supabase Local Development

Run a complete local Supabase stack with Docker and the Supabase CLI.

5|3|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/constellos/claude-code-plugins --skill supabase-local-development
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Supabase Local Development
Source: https://github.com/constellos/claude-code-plugins/tree/main/plugins/nextjs-supabase-ai-sdk-dev/skills/supabase-local-dev
Command: npx skills add https://github.com/constellos/claude-code-plugins --skill supabase-local-development

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a complete local Postgres database with all Supabase services (Auth, Storage, Edge Functions, Realtime) running in Docker containers, enabling offline development, faster iteration, and safe migration testing before production.

Core Features & Use Cases

  • Full Supabase stack running locally
  • Faster development without network latency
  • Safe migration testing before production
  • Automatic TypeScript type generation
  • Environment variable management

Quick Start

Use the Supabase CLI to initialize and start a local project, then run to boot local services and retrieve environment variables. Configure your Next.js app by adding the NEXT_PUBLIC_ variables to .env.local.

Frequently Asked Questions about Supabase Local Development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local Supabase environment for offline development?

To set up a local Supabase environment, use the Supabase CLI to initialize your project and boot local services like Postgres and Auth in Docker containers. This enables complete offline development without network latency.

Can I test database migrations locally before deploying to production?

Yes, you can safely test database migrations locally before production. Running the full Supabase stack in Docker containers provides an isolated environment to validate schema changes and ensure migration integrity without affecting live data.

How does local Supabase type generation work for TypeScript?

Local Supabase type generation automatically creates TypeScript definitions from your local Postgres schema. By using the Supabase CLI, you generate accurate types directly from your offline database, ensuring type safety during development.

Do I need Docker and the Supabase CLI to run local Supabase services?

Yes, Docker and the Supabase CLI are required to run local Supabase services. The CLI manages project initialization and startup, while Docker hosts the complete local stack including Postgres, Auth, Storage, Edge Functions, and Realtime components.

How do I manage environment variables when running Supabase locally?

When running Supabase locally, environment variable management is handled by the CLI during startup. You retrieve the necessary local environment variables and configure your application, such as adding NEXT_PUBLIC_ variables to your .env.local file.

What is the best way to develop Supabase Edge Functions offline?

The best way to develop Supabase Edge Functions offline is by running the complete local Supabase stack in Docker. This provides the necessary local Auth, Storage, and Realtime dependencies, allowing faster iteration without network latency.