supabase-local

Manage local Supabase environments with custom ports and migrations.

2|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/jclfocused/claude-agents --skill supabase-local
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supabase-local
Source: https://github.com/jclfocused/claude-agents/tree/main/skills/supabase-local
Command: npx skills add https://github.com/jclfocused/claude-agents --skill supabase-local

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the setup, configuration, and management of local Supabase instances, ensuring proper port allocation and migration handling to avoid conflicts and data loss.

Core Features & Use Cases

  • Local Supabase Setup: Initializes and starts a local Supabase environment.
  • Custom Port Configuration: Assigns unique port ranges to prevent conflicts between multiple Supabase instances.
  • Migration Management: Guides users through creating, editing, and applying database migrations safely.
  • Type Generation: Automates the regeneration of TypeScript types from the local database schema.
  • Use Case: When starting a new project that requires a local Supabase database, use this Skill to initialize the environment, configure custom ports, and set up the initial database schema and migrations.

Quick Start

Initialize a new local Supabase project in the backend directory and start it.

Frequently Asked Questions about supabase-local

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

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

To set up a local Supabase environment, initialize a new project in your backend directory and start it using npx supabase CLI commands. This provides a local database setup without needing the cloud.

How do I prevent port conflicts when running multiple local Supabase instances?

To prevent port conflicts with multiple local Supabase instances, configure custom port ranges during initialization. This ensures unique port assignments for concurrent local development environments.

What is the best way to handle database migrations in local Supabase?

Handling local Supabase migrations involves using the CLI to create, edit, and apply schema migrations safely. This guides you through updating the database structure while avoiding data loss.

Can I generate TypeScript types from a local Supabase database schema?

Yes, you can automate regenerating TypeScript types directly from your local Supabase database schema. This ensures your application types remain synchronized with your local database structure.

Does local Supabase development require Docker?

Local Supabase development relies on Docker to run the local instances and manage dependencies. Docker provides the isolated containers needed to operate the local database and services.