Kuran-ı Kerim’in dijital ortamda doğru, erişilebilir ve kullanıcı dostu bir şekilde sunulmasını amaçlayan açık kaynaklı bir web uygulaması projesidir.

Bu proje, Diyanet İşleri Başkanlığı Strateji ve Geliştirme Başkanlığı Bilgi İşlem Daire Başkanlığı (@diyanet-bid) koordinasyonunda, yazılım topluluklarının gönüllü katkılarıyla geliştirilmektedir. Amacımız, herkesin Allah’ın kelamına kolay, güvenli ve işlevsel biçimde ulaşabileceği, çağdaş yazılım standartlarına uygun ve zengin özelliklerle donatılmış bir dijital platform oluşturmaktır.

Açık Kaynaklı Kur’an-ı Kerim Web Uygulaması, Kur’an-ı Kerim’in dijital çağın imkânlarıyla daha geniş kitlelere sahih, erişilebilir ve kullanıcı dostu bir biçimde ulaştırılmasını amaçlamaktadır.

Bu kapsamda proje aşağıdaki temel hedefleri benimsemektedir:

• Evrensel Erişim: Herkesin, her yerden ve herhangi bir ücret ya da engelle karşılaşmaksızın Kur’an-ı Kerim’e web üzerinden kolayca ulaşabilmesini sağlamak.
• Doğruluk ve Güvenilirlik: Diyanet İşleri Başkanlığı Mushafları İnceleme ve Kıraat Kurulu tarafından onaylanmış metinler ile güvenilir kaynaklardan alınan tefsir ve mealleri esas almak.
• Modern Kullanıcı Deneyimi: Next.js 15+ ve Redux Toolkit gibi güncel web teknolojileriyle geliştirilen hızlı, sade, erişilebilir ve estetik bir kullanıcı arayüzü sunmak.
• Katılımcı Gelişim: Yazılım geliştiriciler, tasarımcılar ve Kur’an-ı Kerim ilimlerine hâkim gönüllü uzmanların katkılarıyla projeyi sürekli geliştirmek ve zenginleştirmek.
• Açık Kaynak Felsefesi: Şeffaflık, iş birliği ve bilgi paylaşımını esas alarak sürdürülebilir bir dijital hizmet modeli oluşturmak.

Açık Kaynaklı Kur’an-ı Kerim Web Uygulaması, başlangıç fazında aşağıdaki temel işlevleri sunmayı hedeflemektedir:

• Farklı hat seçenekleri (Mushaf-ı Şerif, Medine hattı vb.)
• Sayfa, cüz, sure ve ayet bazında esnek gezinme
• Gece/gündüz modu ve ayarlanabilir yazı tipi boyutları

• Diyanet İşleri Başkanlığı Meali ve güvenilir kaynaklardan mealler
• Seçilebilir tefsir içerikleri (ör. Diyanet Tefsiri)
• Aynı anda birden fazla meal veya tefsir görüntüleme

• Tanınmış kârilerden farklı kıraat seçenekleri
• Ayet veya sure bazında sesli takip

• Kur’an metni, meal ve tefsirlerde temel düzeyde metin arama

• Yer imi (bookmark) ekleme
• Son okunan konumun kaydedilmesi
• Tema ve yazı tipi ayarlarının korunması

• Web İçeriği Erişilebilirlik Yönergeleri (WCAG) doğrultusunda temel erişilebilirlik standartları

Bu özellikler sayesinde kullanıcılar Kur’an-ı Kerim’e dijital ortamda sahih, estetik ve kullanıcı merkezli bir şekilde erişebilecektir.

Bu proje tamamen frontend odaklı bir web uygulaması olarak geliştirilmektedir:

• Framework: Next.js 15+ (App Router)
• Programlama Dili: TypeScript (strict mode aktif)
• Durum Yönetimi: Zustand + TanStack Query (server state için)
• Stil: Tailwind CSS
• UI Bileşenleri: Radix UI + shadcn/ui
• Form Yönetimi: React Hook Form + Zod validation
• Tema Yönetimi: next-themes (dark/light mode)
• Fontlar: Inter (Latin), Amiri (Arapça)
• API Entegrasyonu: Native fetch API (Diyanet Kur'an API ile)
• Linting & Formatting: ESLint, TypeScript strict
• Versiyon Kontrol: Git & GitHub
• Paket Yöneticisi: npm

• React 19 - UI framework
• Radix UI - Accessible UI primitives
• Lucide React - Modern icon library
• Class Variance Authority - CSS class management
• Tailwind Merge & Animate - Styling utilities

Not: Bu proje başlangıç aşamasında bir backend veya veritabanı içermemektedir. Tüm veriler Diyanet Kur'an API'den çekilir, kullanıcıya özel ayarlar çerezlerde (cookies) saklanır.

# Projeyi klonlayın
git clone https://github.com/diyanet-bid/kuran.git
cd kuran

# Bağımlılıkları yükleyin
npm install

# Ortam değişkenlerini ayarlayın
cp .env.example .env.local

# Geliştirme sunucusunu başlatın
npm run dev

Uygulama http://localhost:3000 adresinde çalışmaya başlayacaktır.

Kapsamlı kurulum talimatları, sistem gereksinimleri ve sorun giderme için INSTALLATION.md dosyasını inceleyiniz.

API Erişimi: Diyanet Kur'an API token'ı almak için: https://acikkaynakkuran-dev.diyanet.gov.tr

Bu proje hepimizin! Her türlü katkıya açığız ve minnettarız.

• Issues bölümünde yeni bir konu açarak öneri ve hatalarınızı paylaşabilirsiniz.

1. Issues sayfasından görev seçin veya yeni bir görev önerin.
2. Projeyi fork’layın.
3. Yeni bir branch oluşturun: git checkout -b feature/yeni-ozellik
4. Değişikliklerinizi commit’leyin (anlamlı commit mesajları kullanın): feat: Ayetlere yer imi ekleme özelliği geliştirildi
5. Branch’inizi push’layın: git push origin feature/yeni-ozellik
6. Ana depoya bir Pull Request (PR) açın. PR’da yaptığınız değişiklikleri detaylıca açıklayın.

• UI/UX tasarımı, ikon ve görseller için Figma, Adobe XD gibi araçlarla katkı sunabilirsiniz.

• Uygulamayı farklı cihaz ve tarayıcılarda test ederek geri bildirim paylaşabilirsiniz.

Lütfen katkıda bulunmadan önce:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md

dosyalarını okuyun.

Amacımız saygılı, yapıcı ve işbirlikçi bir topluluk oluşturmaktır.

Projeye katkı sağlamak veya geri bildirimde bulunmak için aşağıdaki kanalları kullanabilirsiniz:

• GitHub Issues: Hata bildirimi, özellik talepleri ve teknik tartışmalar
• GitHub Discussions: Genel sohbet ve duyurular (aktif ise)
• API Bilgileri: Kur’an API Dokümantasyonu
• Diyanet Bilgi İşlem Daire Başkanlığı GitHub: @diyanet-bid
• Resmi İletişim: community@diyanet.gov.tr

🙏 Allah’ın kelamını daha geniş kitlelere ulaştırmak için katkınız çok değerli!