Kurulum ve Başlangıç

Kur'ancılar projesini yerel geliştirme ortamınızda çalıştırmak için aşağıdaki adımları takip edebilirsiniz.

Gereksinimler

  • Node.js 18.17.0 veya üzeri
  • npm veya yarn
  • Git

Adım Adım Kurulum

1. Projeyi Klonlayın

git clone https://github.com/kurancilar/quran.git
cd quran

2. Bağımlılıkları Yükleyin

npm install

3. Çevresel Değişkenler (.env.local)

Kök dizinde .env.local dosyası oluşturun ve aşağıdaki değişkenleri tanımlayın:

# Clerk Auth
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://...
NEXT_PUBLIC_SUPABASE_ANON_KEY=ey...

# Web Push (VAPID)
NEXT_PUBLIC_VAPID_PUBLIC_KEY=...
VAPID_PRIVATE_KEY=...
VAPID_SUBJECT=mailto:admin@example.com

# AI Search (Cerebras)
NEXT_PUBLIC_CEREBRAS_API_KEY=csk-...

4. Veritabanı Hazırlığı

Supabase projenizde SQL editörünü açın ve supabase_schema.sql dosyasındaki komutları çalıştırarak tabloları oluşturun.

5. Uygulamayı Başlatın

npm run dev

Tarayıcınızda http://localhost:3000 adresine giderek uygulamayı görüntüleyebilirsiniz.

🚀 Dağıtım (Deployment)

Bu proje Vercel ile tam uyumludur. Canlıya almak için aşağıdaki adımları izleyebilirsiniz:

  1. Vercel'de Yeni Proje: Vercel dashboard üzerinden "Add New..." butonuna tıklayın ve GitHub reposunu seçin.
  2. Ortam Değişkenleri: Settings > Environment Variables bölümüne .env.local dosyasındaki tüm anahtarları ekleyin.
  3. Build Ayarları: Next.js framework'ü otomatik algılanacaktır. Build komutu next build olarak kalmalıdır.
  4. Deploy: "Deploy" butonuna basın.