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.
Next.js 15, TypeScript, Tailwind CSS ve diğer son teknolojiler ile geliştirilmiştir.
Her kod satırı Kur'an-ı Kerim'i daha erişilebilir kılma amacına hizmet eder.
Katkılarınız dünya çapında milyonlarca Müslümana fayda sağlayacaktır.
Lütfen katkı sağlamadan önce okuyunuz.
Başkanlığımızın görev ve hizmetleri kapsamında hazırlanan Kur'an-ı Kerim, Elif-Bâ ve benzeri içeriklere ait metin, ses dosyası, veri seti, kaynak dosya ve diğer dijital materyaller; içerik bütünlüğünün, kaynak güvenilirliğinin ve kurumsal sorumluluğun korunması amacıyla firma, vatandaş, bireysel yazılım geliştiricisi veya diğer üçüncü kişilerle paylaşılmamaktadır.
Başkanlığımız tarafından kamuoyunun kullanımına sunulan içeriklere, kurumsal internet sitelerimiz ve mobil uygulamalarımız üzerinden erişilebilmektedir. Bu platformlarda yayımlanan içeriklerin farklı uygulamalarda kullanılmak üzere toplu olarak aktarılması, çoğaltılması, yeniden yayımlanması veya kaynak dosyalarının temin edilmesine yönelik talepler karşılanamamaktadır.
Bu sayfanın amacı; Başkanlığımız tarafından yürütülen veya geliştirilmesi planlanan projelere topluluk üyelerinin katkı sağlamasıdır. Buradaki API ve içerikler yalnızca bu projenin geliştirilmesi kapsamında kullanılmak üzere sunulmakta olup, bağımsız ürün geliştirme amacıyla kullanılamaz.
Hızlı Başlangıç
Projeyi yerel ortamınızda birkaç dakikada çalıştırın.
Depoyu klonlayın
git clone https://github.com/diyanet-bid/Kuran.gitBağımlılıkları yükleyin
npm installGeliştirme sunucusunu başlatın
npm run devTarayıcınızı açın
http://localhost:3000Ortam 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şimi yalnızca bu projeye katkı sağlamak amacıyla verilmektedir; bağımsız uygulamalarda kullanılamaz. Bilgilendirme metnini okuyun
Alternatif olarak Docker kullanarak projeyi çalıştırabilirsiniz
Docker Compose ile başlatın
docker-compose up -dTarayıcınızı açın
http://localhost:3000Nasıl Katkıda Bulunulur
Her seviyeden geliştiricinin katkılarını memnuniyetle karşılıyoruz.
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.
Sorunlar, tartışmalar ve kod katkıları.
Depoyu GörüntüleÖnemli konular için doğrudan iletişim.
E-posta GönderGeliştirici Kaynakları
Projeyi anlamak ve katkıda bulunmak için ihtiyacınız olan her şey.
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
Kur'an veri kaynaklarıyla entegrasyon için kapsamlı API dokümantasyonu.
Uygulama boyunca kullanılan tasarım kılavuzları, bileşenler ve desenler.
Geliştiriciler ve katkıda bulunanlar için detaylı dokümantasyon.
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