Next.js ile site yaparken Claude (veya Cursor) kullanan varsa muhtemelen benimle
aynı kanser süreçleri yaşıyordur. Basit bir statik site yapacaksın; gidiyor
kafasına göre Supabase/Prisma dayamaya çalışıyor, görsellere boyut vermediği
için sayfa yüklenirken zıplayıp duruyor (CLS), Framer Motion'ı öyle bir yazıyor
ki F5 atınca sayfa titriyor, durduk yere her işe modal/pop-up açıyor...
İşin kötüsü, Claude'a "kardeşim çalışan kodu niye bozdun, statik yap dedik
veritabanı niye ekledin" diye laf anlatıp düzelttirene kadar dünya kadar
gereksiz token yanıyor, limitler ve cepler boş yere eriyor.
Ben de her projede aynı dertleri yaşamaktan gına geldiği için, Claude'un önüne
set çeken tek bir kural dosyası (CLAUDE.md / .cursorrules) hazırladım. Kendim
projelerimde denedim, bayağı bir rahatlattı. Sizlerin de işine yarasın, boş yere
token yakmayın diye GitHub'a açık kaynak olarak yükledim.
Bu dosya projede olunca kısaca şunları engelliyor:
- Veritabanı uydurmasını tamamen yasaklıyor (tamamen statik/Vercel uyumlu
gidiyor).
- Görselleri disipline sokuyor, sayfa kayması (CLS) sıfır oluyor.
- Framer Motion'daki o F5 titremesini / hydration hatalarını önlüyor.
- Gereksiz 200 satırlık karmaşık kodlar yazmak yerine sade kod yazıyor
(böylece ciddi anlamda token tasarrufu sağlıyor).
- Saçma sapan pop-up ve mobilde taşma yapan ekran hatalarını kesiyor.
Nasıl Kullanılır? Çok basit, projenizin ana klasöründe terminale şunu
yapıştırmanız yetiyor:
curl -o CLAUDE.md https://raw.githubusercontent.com/ocalirdigital/nextjs-static-rules/main/CLAUDE.md(Cursor kullanıyorsanız dosya adını .cursorrules yapabilirsiniz).
Dosyanın en tepesinde TARGET_LANGUAGE: "tr" kısmı var, siteyi hangi dilde
yapıyorsanız onu yazın gerisini Claude'a bırakın.
GitHub Linki:
👉 https://github.com/ocalirdigital/nextjs-static-rules
Ben kendi işlerimde çok faydasını gördüm. Bir projede deneyip farkı kendiniz de
görebilirsiniz. Eksik veya "şunu da eklesek iyi olur" dediğiniz bir kural olursa
yazın, beraber ekleyelim geliştirelim.
İşinizi görürse repoya bir yıldız (⭐) bırakırsanız çok mutlu olurum, herkese iyi
pazarlar dilerim!
