supabase-install-auth

Install and configure Supabase SDK, CLI, and project authentication. Use when setting up a new Supabase project, installing @supabase/supabase-js, configuring environment variables, or initializing the Supabase client. Trigger with "install supabase", "setup supabase", "supabase auth config", "configure supabase", "supabase init", "add supabase to project".

Jump to install

Repository: jeremylongshore/claude-code-plugins-plus-skills
Last source activity: July 19, 2026 at 02:55
Detected SKILL.md language: English
Stars: 2,604
Forks: 378

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	supabase-install-auth
description	Install and configure Supabase SDK, CLI, and project authentication. Use when setting up a new Supabase project, installing @supabase/supabase-js, configuring environment variables, or initializing the Supabase client. Trigger with "install supabase", "setup supabase", "supabase auth config", "configure supabase", "supabase init", "add supabase to project".
allowed-tools	Read, Write, Edit, Bash(npm:), Bash(npx:), Bash(pnpm:), Bash(pip:), Bash(supabase:*), Grep, Glob
version	1.53.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","supabase","setup","authentication","sdk"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Supabase Install & Auth

Overview

Install the Supabase SDK, CLI, and project credentials from scratch — covering package install, environment configuration, client initialization, and connection verification for both TypeScript (@supabase/supabase-js) and Python (supabase).

Key facts:

npm package: @supabase/supabase-js
Python package: supabase (via pip)
Client factory: createClient() — never new SupabaseClient()
Dashboard: https://supabase.com/dashboard (Settings > API for keys)
Docs: https://supabase.com/docs

Prerequisites

Node.js 18+ (for JS/TS) or Python 3.8+ (for Python)
Package manager: npm, pnpm, or yarn (JS) / pip (Python)
A Supabase project created at https://supabase.com/dashboard
Docker Desktop (only if using local development via supabase start)

Instructions

Step 1 — Install the SDK and CLI

Install the SDK and the Supabase CLI:

JavaScript / TypeScript:

# Install the SDK
npm install @supabase/supabase-js

# For SSR frameworks (Next.js, SvelteKit, Nuxt), also install:
npm install @supabase/ssr

# Install the Supabase CLI (for types, migrations, local dev)
npm install -D supabase

Python:

# Install the SDK
pip install supabase

# Install the CLI (alternative: brew install supabase/tap/supabase)
npm install -g supabase

Verify the CLI is available:

npx supabase --version

Step 2 — Configure Environment Variables

Retrieve project credentials from the Supabase Dashboard (Settings > API) and create the env file:

# .env.local (or .env)
SUPABASE_URL=https://<project-ref>.supabase.co
SUPABASE_KEY=eyJhbGciOiJIUzI1NiIs...          
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1...

.env
.env.local
.env.*.local

// lib/supabase.ts
import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  process.env.SUPABASE_URL!,
  process.env.SUPABASE_KEY!
)

export default supabase

// lib/supabase-admin.ts
import { createClient } from '@supabase/supabase-js'

export const supabaseAdmin = createClient(
  process.env.SUPABASE_URL!,
  process.env.SUPABASE_SERVICE_ROLE_KEY!,
  {
    auth: {
      autoRefreshToken: false,
      persistSession: false,
    },
  }
)

# lib/supabase_client.py
import os
from supabase import create_client

url = os.environ["SUPABASE_URL"]
key = os.environ["SUPABASE_KEY"]

supabase = create_client(url, key)

// Quick connectivity check
const { data, error } = await supabase.from('_health_check').select('*').limit(1)
if (error && error.code !== 'PGRST116') {
  // PGRST116 = relation does not exist (expected if table doesn't exist yet)
  throw new Error(`Supabase connection failed: ${error.message}`)
}
console.log('Supabase connected successfully')

npx supabase login
npx supabase link --project-ref <your-project-ref>
npx supabase gen types typescript --linked > lib/database.types.ts

import type { Database } from './database.types'
const supabase = createClient<Database>(url, key)

Error	Cause	Fix
`FetchError: request failed`	Wrong `SUPABASE_URL`	Verify URL at Dashboard > Settings > API
`Invalid API key`	Wrong or expired key	Copy fresh anon key from Dashboard > Settings > API
`PGRST301: JWSError`	Malformed JWT in key	Remove trailing whitespace/newlines from env var
`Cannot find module '@supabase/supabase-js'`	SDK not installed	Run `npm install @supabase/supabase-js`
`ModuleNotFoundError: No module named 'supabase'`	Python SDK not installed	Run `pip install supabase`
`supabase: command not found`	CLI not installed	Run `npm install -D supabase`, then use `npx supabase`
`Error: supabase start` fails	Docker not running	Start Docker Desktop, then retry `npx supabase start`
`TypeError: SupabaseClient is not a constructor`	Wrong import pattern	Use `createClient()` — not `new SupabaseClient()`