Hızlı Başlangıç

Bu hızlı başlangıç kılavuzuyla uygulamanızı dakikalar içinde çalışır hale getirin.

Not: Bu içerik, yalnızca gösterim amaçlı örnek/yer tutucu içeriktir.

Geliştirme ortamınızı hızlıca kurup çalıştırın.

Ön Koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Node.js 18.x veya üzeri
  • pnpm 8.x veya üzeri
  • Sürüm kontrolü için Git
  • Bir Supabase hesabı (ücretsiz plan gayet iyi iş görür)

Adım 1: Depoyu Klonlayın

git clone https://github.com/yourorg/yourapp.git
cd yourapp

Adım 2: Bağımlılıkları Yükleyin

pnpm install

Bu komut, monorepo genelinde gerekli tüm bağımlılıkları yükleyecektir.

Adım 3: Ortam Değişkenlerini Ayarlayın

Örnek ortam dosyasını kopyalayın:

cp apps/web/.env.example apps/web/.env.local

Aşağıdaki değişkenleri güncelleyin:

# Supabase Yapılandırması
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

# Uygulama
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Adım 4: Supabase'i Başlatın

Yerel Supabase örneğinizi başlatın:

pnpm supabase:web:start

Bu komut şunları yapacaktır:

  • PostgreSQL veritabanını başlatır
  • Supabase Studio'yu başlatır (localhost:54323)
  • Tüm migration'ları uygular
  • Başlangıç verilerini yükler

Adım 5: Geliştirme Sunucusunu Başlatın

pnpm dev

Uygulamanız şu adreslerde erişilebilir olacaktır:

  • Uygulama: http://localhost:3000
  • Supabase Studio: http://localhost:54323
  • E-posta Testi: http://localhost:54324

Adım 6: İlk Kullanıcınızı Oluşturun

  1. http://localhost:3000/auth/sign-up adresine gidin
  2. E-posta adresinizi ve şifrenizi girin
  3. Onay e-postası için http://localhost:54324 adresini kontrol edin
  4. Onay bağlantısına tıklayın
  5. Artık hazırsınız!

Sonraki Adımlar

Uygulamanız artık çalıştığına göre:

  1. Panoyu Keşfedin - Temel özelliklere göz atın
  2. Kodu İnceleyin - Yapıya aşina olun
  3. Dokümantasyonu Okuyun - Temel kavramları öğrenin
  4. Özelliğinizi Geliştirin - Özelleştirmeye başlayın

Sık Karşılaşılan Sorunlar

Port Zaten Kullanımda

3000 numaralı port zaten kullanımdaysa:

# İşlemi bulun ve sonlandırın
lsof -i :3000
kill -9 <PID>

Supabase Başlamıyor

Supabase'i sıfırlamayı deneyin:

pnpm supabase:web:stop
docker system prune -a  # Docker'ı temizleyin
pnpm supabase:web:start

Veritabanı Bağlantı Hatası

Docker'ın çalıştığından emin olun ve Supabase'i yeniden başlatın:

docker ps  # Docker'ın çalıştığını kontrol edin
pnpm supabase:web:reset

Sırada Ne Var?