38980-vm/app-9w9pd00g5j41/CLERK_QUICK_REFERENCE.md

🔑 Clerk API Anahtarları - Hızlı Referans

Gerekli Anahtarlar

1. Frontend Anahtarı (.env dosyası)

VITE_CLERK_PUBLISHABLE_KEY=pk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

• Nereden: Clerk Dashboard > API Keys > Publishable Key
• Format: pk_test_... veya pk_live_...
• Kullanım: React uygulaması (tarayıcıda görünür)

2. Backend Anahtarları (Supabase Secrets)

CLERK_SECRET_KEY=sk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
CLERK_WEBHOOK_SECRET=whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

• CLERK_SECRET_KEY:

  • Nereden: Clerk Dashboard > API Keys > Secret Keys
  • Format: sk_test_... veya sk_live_...
  • ⚠️ GİZLİ - Asla frontend'de kullanmayın!

• CLERK_WEBHOOK_SECRET:

  • Nereden: Clerk Dashboard > Webhooks > Signing Secret
  • Format: whsec_...
  • Webhook URL: https://vtztatcglebrnvikvntf.supabase.co/functions/v1/clerk-webhook

---

🚀 Hızlı Kurulum (3 Adım)

Adım 1: Clerk'ten Anahtarları Al

1. https://clerk.com/ adresine git
2. Hesap oluştur ve yeni uygulama ekle
3. API Keys sayfasından anahtarları kopyala

Adım 2: Frontend Anahtarını Yapılandır

# .env dosyasına ekle
VITE_CLERK_PUBLISHABLE_KEY=pk_test_...

Adım 3: Backend Anahtarlarını Yapılandır

1. Supabase Dashboard'a git: https://supabase.com/dashboard
2. Edge Functions > Manage secrets
3. İki secret ekle:
   • CLERK_SECRET_KEY
   • CLERK_WEBHOOK_SECRET

---

✅ Doğrulama

Frontend Test

# Development server'ı başlat
npm run dev

# Tarayıcıda aç: http://localhost:5173
# Sign In sayfasına git - Clerk formu görünmeli

Backend Test

1. Admin Panel > Clerk Diagnostics
2. "Test Clerk Connection" butonuna tıkla
3. Başarılı mesajı görmelisin

---

🐛 Sorun mu Yaşıyorsun?

"Clerk key bulunamadı" hatası

# .env dosyasını kontrol et
cat .env | grep CLERK

# Server'ı yeniden başlat
npm run dev

"Invalid API key" hatası

• Anahtarı yeniden kopyala (boşluk olmamalı)
• Doğru environment kullandığından emin ol (test/live)
• Clerk Dashboard'da anahtarın aktif olduğunu kontrol et

---

📚 Detaylı Dokümantasyon

Tüm detaylar için: CLERK_SETUP_GUIDE.md

---

🔗 Hızlı Linkler

• Clerk Dashboard: https://dashboard.clerk.com/
• API Keys: https://dashboard.clerk.com/last-active?path=api-keys
• Webhooks: https://dashboard.clerk.com/last-active?path=webhooks
• Supabase Dashboard: https://supabase.com/dashboard/project/vtztatcglebrnvikvntf
• Clerk Docs: https://clerk.com/docs

---

💡 İpucu: Anahtarları aldıktan sonra bu dosyayı sil veya .gitignore'a ekle!