supabase-hello-world

jeremylongshore's avatarfrom jeremylongshore

Create a minimal working Supabase example.Use when starting a new Supabase integration, testing your setup,or learning basic Supabase API patterns.Trigger with phrases like "supabase hello world", "supabase example","supabase quick start", "simple supabase code".

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026
[API Helpers]

When & Why to Use This Skill

This Claude skill streamlines the initial setup of Supabase integrations by generating minimal, functional boilerplate code. It helps developers quickly verify environment configurations, learn standard API patterns for database operations, and implement basic CRUD functionality in both TypeScript and Python, significantly reducing the time spent on manual setup and documentation lookups.

Use Cases

  • New Project Initialization: Quickly generate the essential boilerplate code required to connect a new application to a Supabase backend.
  • Connectivity Testing: Validate that environment variables and API credentials (like SUPABASE_API_KEY) are correctly configured by performing a simple database insert and select operation.
  • Learning API Patterns: Provide a clear, executable reference for developers new to Supabase to understand client initialization and basic table interactions.
  • Cross-Language Implementation: Offer ready-to-use snippets for both TypeScript and Python environments, ensuring consistent integration patterns across different tech stacks.
namesupabase-hello-world
description|
allowed-toolsRead, Write, Edit
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

Supabase Hello World

Overview

Minimal working example demonstrating core Supabase functionality.

Prerequisites

  • Completed supabase-install-auth setup
  • Valid API credentials configured
  • Development environment ready

Instructions

Step 1: Create Entry File

Create a new file for your hello world example.

Step 2: Import and Initialize Client

import { SupabaseClient } from '@supabase/supabase-js';

const client = new SupabaseClient({
  apiKey: process.env.SUPABASE_API_KEY,
});

Step 3: Make Your First API Call

async function main() {
  const result = await supabase.from('todos').insert({ task: 'Hello!' }).select(); console.log(result.data);
}

main().catch(console.error);

Output

  • Working code file with Supabase client initialization
  • Successful API response confirming connection
  • Console output showing:
Success! Your Supabase connection is working.

Error Handling

Error Cause Solution
Import Error SDK not installed Verify with npm list or pip show
Auth Error Invalid credentials Check environment variable is set
Timeout Network issues Increase timeout or check connectivity
Rate Limit Too many requests Wait and retry with exponential backoff

Examples

TypeScript Example

import { SupabaseClient } from '@supabase/supabase-js';

const client = new SupabaseClient({
  apiKey: process.env.SUPABASE_API_KEY,
});

async function main() {
  const result = await supabase.from('todos').insert({ task: 'Hello!' }).select(); console.log(result.data);
}

main().catch(console.error);

Python Example

from supabase import SupabaseClient

client = SupabaseClient()

response = supabase.table('todos').insert({'task': 'Hello!'}).execute(); print(response.data)

Resources

Next Steps

Proceed to supabase-local-dev-loop for development workflow setup.