React Projesi Kurulumu ve AJV Hatası Çözüm Rehberi

Bu dokümanda React projesinin npx create-react-app kullanılarak nasıl oluşturulacağı ve kurulum sırasında veya sonrasında karşılaşılabilecek ‘ajv/dist/compile/codegen’ hatasının nedenleri ve çözüm yolları sunum formatında anlatılmaktadır.

1. React Nedir?

React, Facebook tarafından geliştirilen, bileşen (component) tabanlı modern bir JavaScript kütüphanesidir. Tek sayfa uygulamalar (SPA) geliştirmek için kullanılır.

2. React Kurulumu (npx create-react-app)

Adım 1: Node.js kontrolü

React kurulumu için bilgisayarda Node.js (18 veya üzeri) kurulu olmalıdır.
Kontrol etmek için terminalde aşağıdaki komutlar çalıştırılır:
node -v
npm -v

Adım 2: React projesi oluşturma

Aşağıdaki komut ile React projesi oluşturulur:
npx create-react-app my-app

Adım 3: Projeyi çalıştırma

cd my-app
npm start

Uygulama varsayılan olarak http://localhost:3000 adresinde çalışır.

3. Kurulum Sonrası Olası Hata

Bazı durumlarda proje çalıştırılırken aşağıdaki hata alınabilir:

Cannot find module ‘ajv/dist/compile/codegen’

4. Hatanın Sebebi

Bu hata genellikle ajv paketinin farklı sürümleri arasında uyumsuzluk olmasından kaynaklanır. create-react-app, bazı bağımlılıklar üzerinden ajv kullanır ve npm yanlış sürümü çektiğinde bu hata ortaya çıkar.

5. Çözüm Yolları

Çözüm 1: node_modules temizleme

node_modules klasörü ve package-lock.json dosyası silinir:
rm -rf node_modules package-lock.json (Mac/Linux)
rmdir /s /q node_modules && del package-lock.json (Windows)

Çözüm 2: Uyumlu ajv sürümünü kurma

npm install ajv@8.12.0 ajv-keywords@5.1.0 –save-dev

Çözüm 3: Bağımlılıkları yeniden kurma

npm install
npm start

6. Kontrol

Ajv sürümünü kontrol etmek için:
npm ls ajv

Tek bir ajv sürümü görünmelidir.

7. Sonuç

Bu dokümanda React projesinin create-react-app ile kurulumu ve sık karşılaşılan ajv hatasının çözümü anlatılmıştır. Bu adımlar izlenerek sorun büyük oranda giderilir.