Skip to content

modern, open-source web application for Shia supplications (Duas) and Ziyarats, featuring audio playback, dark mode, and Persian translations. Built with React 19, TypeScript, and Tailwind CSS.

Notifications You must be signed in to change notification settings

tje3d/dua-treasury

Repository files navigation

گنجینه دعا | Dua Treasury 🌙

React TypeScript Vite License

مشاهده دموی زنده | Live Demo

English | فارسی


فارسی

🚀 مشاهده آنلاین پروژه

گنجینه دعا یک نرم‌افزار متن‌باز و مدرن برای دسترسی به ادعیه و زیارات شیعی است. این پروژه با تمرکز بر تجربه کاربری زیبا، سرعت بالا و قابلیت دسترسی آفلاین (در آینده) طراحی شده است.

🌟 ویژگی‌ها

  • طراحی مدرن و معنوی: استفاده از تایپوگرافی مناسب (وزیر و امیری) و المان‌های اسلیمی.
  • حالت شب و روز: پشتیبانی کامل از حالت تاریک برای مطالعه راحت‌تر در شب.
  • پخش صوتی: امکان شنیدن صوت ادعیه با صدای مداحان برجسته.
  • ترجمه روان: نمایش ترجمه فارسی در کنار متن عربی.
  • خروجی JSON: امکان دانلود متن هر دعا به صورت فایل JSON برای استفاده در پروژه‌های دیگر.
  • واکنش‌گرا (Responsive): نمایش بهینه در تمامی دستگاه‌ها (موبایل، تبلت و دسکتاپ).

📸 تصاویر پروژه

صفحه اصلی صفحه دعا

🛠 تکنولوژی‌های مورد استفاده

  • React 19: کتابخانه قدرتمند رابط کاربری.
  • Vite: ابزار ساخت سریع و مدرن.
  • Tailwind CSS: برای طراحی استایل‌های زیبا و انعطاف‌پذیر.
  • TypeScript: برای افزایش پایداری و دقت در کدنویسی.
  • Lucide React: مجموعه آیکون‌های زیبا و سبک.
  • React Router: برای مدیریت مسیرها در برنامه.

🚀 نصب و راه‌اندازی

برای اجرای پروژه در محیط محلی، مراحل زیر را دنبال کنید:

  1. مخزن را کلون کنید:
    git clone https://github.com/tje3d/dua-treasury.git
  2. وارد پوشه پروژه شوید:
    cd dua-treasury
  3. بسته‌ها را نصب کنید (پیشنهاد می‌شود از bun استفاده کنید):
    bun install
  4. پروژه را اجرا کنید:
    bun run dev

🤝 مشارکت

ما از مشارکت شما برای بهبود این پروژه استقبال می‌کنیم! شما می‌توانید با افزودن دعاهای جدید، بهبود رابط کاربری یا گزارش خطاها به ما کمک کنید.


English

🚀 View Live Demo

Dua Treasury is an open-source, modern web application for accessing Shia supplications (Duas) and Ziyarats. This project focuses on providing a beautiful user experience, high performance, and ease of use.

🌟 Features

  • Modern & Spiritual Design: Utilizing elegant typography (Vazirmatn & Amiri) and Islamic patterns.
  • Dark & Light Mode: Full support for dark mode for comfortable reading at night.
  • Audio Playback: Listen to beautiful recitations for each prayer.
  • Fluent Translation: Persian translations alongside the original Arabic text.
  • JSON Export: Ability to download each prayer's content as a JSON file for use in other projects.
  • Fully Responsive: Optimized for all screen sizes (Mobile, Tablet, Desktop).

📸 Screenshots

Home Screen Dua Screen

🛠 Tech Stack

  • React 19: Modern UI library.
  • Vite: Next-generation frontend tooling.
  • Tailwind CSS: For utility-first styling.
  • TypeScript: Ensuring type safety and better developer experience.
  • Lucide React: For beautiful and lightweight icons.
  • React Router: For seamless navigation.

🚀 Getting Started

To run this project locally, follow these steps:

  1. Clone the repository:
    git clone https://github.com/tje3d/dua-treasury.git
  2. Navigate to the project folder:
    cd dua-treasury
  3. Install dependencies (recommended to use bun):
    bun install
  4. Start the development server:
    bun run dev

🤝 Contributing

Contributions are welcome! Whether it's adding new prayers, improving the UI, or reporting bugs, feel free to open an issue or submit a pull request.


Developed with ❤️ for the community.

About

modern, open-source web application for Shia supplications (Duas) and Ziyarats, featuring audio playback, dark mode, and Persian translations. Built with React 19, TypeScript, and Tailwind CSS.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published