CodeXRay ⚡

Algoritmaların kalbine inin! Yapay Zeka destekli, gerçek zamanlı kod görselleştirme ve analiz aracı.

---

📖 Proje Hakkında

CodeXRay, karmaşık algoritmaları ve veri yapılarını adım adım, interaktif ve dinamik bir şekilde görselleştiren, React ve TypeScript tabanlı modern bir web uygulamasıdır. İçerisinde entegre olarak bulunan "Bilgiç Dede" yapay zeka asistanı sayesinde, sadece kodun nasıl çalıştığını izlemekle kalmaz, aynı zamanda her bir adımın zaman/alan karmaşıklığını ve arkasındaki matematiği de öğrenebilirsiniz.

✨ Temel Özellikler

• Dinamik Görselleştirme: Graf algoritmaları (DFS, BFS, Dijkstra, A*), Sıralama algoritmaları ve String algoritmaları için senaryolar.
• Yapay Zeka Asistanı: YZ modunda veya simüle modda, kodun optimizasyon potansiyelini analiz eder, sorularınızı yanıtlar.
• Zaman Çizelgesi (Timeline): Animasyonları durdurun, geri sarın veya ileri sarın.
• Hazır Senaryolar (Presets): Her algoritma için özel tasarlanmış i1 (Düzenli), i2 (Küme) ve i3 (Kaos) zorluk modları.
• Çoklu Dil Desteği: Türkçe ve İngilizce (TR/EN) dil desteği.
• Modern Arayüz: Siberpunk / Neon esintili, karanlık mod odaklı tasarım.

---

🚀 Kurulum Talimatları

Proje Vite ve React altyapısıyla oluşturulduğu için sisteminizde Node.js (Sürüm 16+) yüklü olması yeterlidir.

🪟 Windows İçin Kurulum

1. Terminali (PowerShell veya CMD) açın.
2. Projeyi bilgisayarınıza indirin:

   git clone https://github.com/Teknesyum/CodeXRay.git

3. İndirdiğiniz klasörün içine girin:

   cd CodeXRay

4. Gerekli kütüphaneleri kurun:

   npm install

5. Projeyi başlatın:

   npm run dev

6. Tarayıcınızda http://localhost:5173 adresine giderek kullanmaya başlayabilirsiniz!

---

🐧 Linux (Ubuntu/Debian) İçin Kurulum

1. Eğer yüklü değilse bağımlılıkları kurun:

   sudo apt update
   sudo apt install nodejs npm git

2. Projeyi klonlayın ve klasöre girin:

   git clone https://github.com/Teknesyum/CodeXRay.git
   cd CodeXRay

3. Bağımlılıkları indirip projeyi çalıştırın:

   npm install
   npm run dev

---

🍎 macOS İçin Kurulum

1. Eğer yüklü değilse Node.js'i Homebrew ile kurun:

   brew install node

2. Terminalinizi açın ve projeyi klonlayın:

   git clone https://github.com/Teknesyum/CodeXRay.git
   cd CodeXRay

3. Kurulumu tamamlayıp uygulamayı başlatın:

   npm install
   npm run dev

---

🤝 Katkıda Bulunma (Contributing)

Bu proje açık kaynaklıdır! Katkıda bulunmak için:

1. Projeyi Fork'layın.
2. Yeni dal oluşturun (git checkout -b feature/YeniÖzellik).
3. Commit atın (git commit -m 'Yeni özellik').
4. Dalınızı pushlayın (git push origin feature/YeniÖzellik).
5. Pull Request açın.