Hoş Geldiniz, Geliştiriciler!

En güzel ve erişilebilir dijital Kur'an deneyimini inşa etmemize katılın. Bu açık kaynak proje topluluk tarafından, topluluk için geliştirilmektedir.

Modern Teknoloji Yığını

Next.js 15, TypeScript, Tailwind CSS ve diğer son teknolojiler ile geliştirilmiştir.

Amaç Odaklı

Her kod satırı Kur'an-ı Kerim'i daha erişilebilir kılma amacına hizmet eder.

Küresel Etki

Katkılarınız dünya çapında milyonlarca Müslümana fayda sağlayacaktır.

Hızlı Başlangıç

Projeyi yerel ortamınızda birkaç dakikada çalıştırın.

Kurulum Talimatları

Depoyu klonlayın

git clone https://github.com/diyanet-bid/Kuran.git

Bağımlılıkları yükleyin

npm install

Geliştirme sunucusunu başlatın

npm run dev

Tarayıcınızı açın

http://localhost:3000

Ortam değişkenlerini ayarlayın

.env.local dosyası oluşturun

Aşağıdaki içeriği .env.local dosyasına ekleyin:

DIB_KURAN_API_BASE_URL=<dib_kuran_api_base_url>
DIB_KURAN_API_TOKEN=<dib_kuran_api_token>

API erişim bilgilerini almak için aşağıdaki siteyi ziyaret edin

Docker ile Çalıştırma

Alternatif olarak Docker kullanarak projeyi çalıştırabilirsiniz

Docker Compose ile başlatın

docker-compose up -d

Tarayıcınızı açın

http://localhost:3000

Nasıl Katkıda Bulunulur

Her seviyeden geliştiricinin katkılarını memnuniyetle karşılıyoruz.

Geliştirme Süreci

1. GitHub'da depoyu fork edin 2. Özellik dalı oluşturun 3. Testlerle birlikte değişikliklerinizi yapın 4. Pull request gönderin 5. Kod incelemesi ve birleştirme

GitHub'da Görüntüle

Kılavuzlar

• TypeScript en iyi uygulamalarını takip edin • Anlamlı commit mesajları yazın • Yeni özellikler için testler ekleyin • İslami değerlere ve içeriğe saygı gösterin • Diğerlerine karşı nazik ve saygılı olun

Katkı sağlayabileceğiniz alanlar

Frontend Geliştirme

React bileşenleri, UI/UX iyileştirmeleri, responsive tasarım, kullanıcı deneyimi geliştirmeleri, performans optimizasyonu, erişilebilirlik iyileştirmeleri

Backend Önerileri

Yeni API rotaları önerileri, mevcut rotalar için iyileştirme talepleri, veri yapısı önerileri, performans iyileştirme önerileri

Çeviri ve Erişilebilirlik

Yeni diller ekleme, mevcut çevirileri iyileştirme, arayüz erişilebilirlik güncelleştirmeleri, İslam alemi için kapsayıcı dil desteği

Topluluğumuza Katılın

Dünyanın dört bir yanından geliştirici ve katkıda bulunanlarla bağlantı kurun.

Topluluk kanalları yakında

Topluluk kanalları yakında.

GitHub

Sorunlar, tartışmalar ve kod katkıları.

Depoyu Görüntüle

E-posta

Önemli konular için doğrudan iletişim.

E-posta Gönder

Geliştirici Kaynakları

Projeyi anlamak ve katkıda bulunmak için ihtiyacınız olan her şey.

Teknoloji Yığını

Framework: Next.js 15+ with App Router

Dil: TypeScript (strict mode)

Stil: Tailwind CSS v4+

Durum: Zustand + TanStack Query

UI: Radix UI + Custom Components

Ses: Howler.js

API Dokümantasyonu

Kur'an veri kaynaklarıyla entegrasyon için kapsamlı API dokümantasyonu.

Tasarım Sistemi

Uygulama boyunca kullanılan tasarım kılavuzları, bileşenler ve desenler.

Dokümantasyon

Geliştiriciler ve katkıda bulunanlar için detaylı dokümantasyon.

İletişim ve Destek

Teknik Sorular

Teknik sorular ve özellik istekleri için GitHub Discussions kullanın.

Hata Raporları

Hataları detaylı yeniden üretim adımlarıyla GitHub Issues üzerinden bildirin.

Genel Sorular

Bize şu adresten e-posta gönderin: community@diyanet.gov.tr