How to Use Supabase Edge Functions

1# Initialize Supabase (skip if already done)
2supabase init
3
4# Create a new Edge Function
5supabase functions new hello-world
6
7# Resulting structure:
8# supabase/
9#   functions/
10#     hello-world/
11#       index.ts

1// supabase/functions/_shared/cors.ts
2export const corsHeaders = {
3  'Access-Control-Allow-Origin': '*',
4  'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
5  'Access-Control-Allow-Methods': 'POST, GET, OPTIONS, PUT, DELETE',
6}
7
8// supabase/functions/hello-world/index.ts
9import { corsHeaders } from '../_shared/cors.ts'
10
11Deno.serve(async (req) => {
12  // Handle CORS preflight
13  if (req.method === 'OPTIONS') {
14    return new Response('ok', { headers: corsHeaders })
15  }
16
17  const { name } = await req.json()
18  const data = { message: `Hello ${name}!` }
19
20  return new Response(JSON.stringify(data), {
21    headers: { ...corsHeaders, 'Content-Type': 'application/json' },
22    status: 200,
23  })
24})

1import { createClient } from 'npm:@supabase/supabase-js@2'
2import { corsHeaders } from '../_shared/cors.ts'
3
4Deno.serve(async (req) => {
5  if (req.method === 'OPTIONS') {
6    return new Response('ok', { headers: corsHeaders })
7  }
8
9  // Create client with user's auth context
10  const supabase = createClient(
11    Deno.env.get('SUPABASE_URL')!,
12    Deno.env.get('SUPABASE_ANON_KEY')!,
13    {
14      global: {
15        headers: { Authorization: req.headers.get('Authorization')! },
16      },
17    }
18  )
19
20  const { data, error } = await supabase.from('todos').select('*')
21
22  return new Response(JSON.stringify({ data, error }), {
23    headers: { ...corsHeaders, 'Content-Type': 'application/json' },
24  })
25})

1# Start local Supabase (if not running)
2supabase start
3
4# Serve Edge Functions with hot reload
5supabase functions serve
6
7# Test with curl
8curl -i --location --request POST \
9  'http://localhost:54321/functions/v1/hello-world' \
10  --header 'Authorization: Bearer YOUR_ANON_KEY' \
11  --header 'Content-Type: application/json' \
12  --data '{"name": "World"}'

1# Link to your remote project
2supabase link --project-ref your-project-ref
3
4# Set custom secrets
5supabase secrets set STRIPE_SECRET_KEY=sk_live_...
6supabase secrets set OPENAI_API_KEY=sk-...
7
8# Deploy a single function
9supabase functions deploy hello-world
10
11# Deploy all functions at once
12supabase functions deploy

1import { createClient } from '@supabase/supabase-js'
2
3const supabase = createClient(
4  'https://your-project.supabase.co',
5  'your-anon-key'
6)
7
8const { data, error } = await supabase.functions.invoke('hello-world', {
9  body: { name: 'World' },
10})
11
12console.log(data) // { message: 'Hello World!' }