Skip to content

Repository files navigation

Cheghad (چقد) 🪙

GitHub Release GitHub Stars GitHub Issues GitHub License GitHub Last Commit

Kotlin Jetpack Compose Material 3 Room Retrofit

یک اپلیکیشن سریع، مدرن و اوپن‌سورس برای مشاهده و مدیریت نرخ ارزها

🇮🇷 فارسی🇬🇧 English


فارسی

📱 درباره چقد

چقد (Cheghad) یک اپلیکیشن مدرن، سبک و اوپن‌سورس برای مشاهده و بررسی نرخ لحظه‌ای ارزها و اطلاعات مالی است.

چقد با استفاده از جدیدترین رویکردهای توسعه اندروید و رابط کاربری Material 3 Expressive ساخته شده و تمرکز آن روی سرعت، سادگی، تجربه کاربری روان و دسترسی سریع به اطلاعات است.

این پروژه با Kotlin و Jetpack Compose توسعه داده شده و از معماری Offline-First برای ارائه تجربه‌ای سریع و قابل‌اعتماد استفاده می‌کند.


✨ ویژگی‌ها

  • 🎨 رابط کاربری مدرن

    • طراحی شده با Material 3 Expressive
    • پشتیبانی از حالت روشن و تاریک
    • طراحی سازگار با اندازه‌های مختلف صفحه‌نمایش
  • کار کردن به صورت آفلاین

    • ذخیره اطلاعات به‌صورت محلی
    • استفاده از Room Database
    • دسترسی سریع به اطلاعات ذخیره‌شده حتی بدون اینترنت
  • 🔄 همگام‌سازی هوشمند

    • دریافت اطلاعات جدید از API
    • بروزرسانی داده‌ها با Retrofit
    • استفاده از Kotlin Coroutines برای عملیات غیرهمزمان
  • 🔔 هشدارها و یادآورها

    • امکان تعریف هشدارهای مالی
    • یادآوری برای پیگیری قیمت‌ها و اطلاعات موردنظر
  • 🚀 سبک و سریع

    • تمرکز روی عملکرد و مصرف بهینه منابع
    • رابط کاربری روان با Jetpack Compose
  • 🔓 اوپن سورس

    • کد منبع عمومی
    • توسعه و مشارکت آزاد در پروژه

🛠️ تکنولوژی‌ها

تکنولوژی کاربرد
Kotlin زبان اصلی توسعه
Jetpack Compose رابط کاربری
Material 3 Expressive طراحی و کامپوننت‌های UI
Room ذخیره‌سازی محلی
Retrofit ارتباط با API
Kotlin Coroutines عملیات asynchronous
Gradle سیستم Build

📥 نصب

برای دریافت آخرین نسخه، به بخش Releases مخزن مراجعه کنید:

👉 دانلود آخرین نسخه


💻 اجرای پروژه در Android Studio

ابتدا مخزن را Clone کنید:

git clone https://github.com/mmdparsa-dev/Cheghad.git

سپس:

  1. پروژه را در Android Studio باز کنید.
  2. اجازه دهید Gradle تمام Dependencyها را Sync کند.
  3. یک Emulator یا دستگاه Android متصل کنید.
  4. پروژه را Build و اجرا کنید.

🤝 مشارکت در پروژه

چقد یک پروژه Open Source است و از مشارکت توسعه‌دهندگان استقبال می‌کند.

اگر پیشنهادی برای بهبود پروژه دارید یا با مشکلی مواجه شدید:

  • یک Issue ایجاد کنید.
  • تغییرات خود را در یک Pull Request ارسال کنید.
  • پیشنهادها و ایده‌های جدید خود را مطرح کنید.

English

📱 About Cheghad

Cheghad is a modern, lightweight, and open-source Android application for monitoring real-time currency exchange rates and financial information.

Built with modern Android development practices and Material 3 Expressive, Cheghad focuses on speed, simplicity, performance, and a smooth user experience.

The application is developed using Kotlin and Jetpack Compose, with an Offline-First approach for fast and reliable access to locally stored data.


✨ Features

  • 🎨 Modern UI

    • Built with Material 3 Expressive
    • Light and Dark theme support
    • Responsive design
  • Offline-First

    • Local data persistence
    • Powered by Room Database
    • Fast access to cached data without an internet connection
  • 🔄 Smart Synchronization

    • Fetches the latest data from APIs
    • Network communication powered by Retrofit
    • Asynchronous operations with Kotlin Coroutines
  • 🔔 Alerts & Reminders

    • Custom financial alerts
    • Reminders for tracking prices and financial information
  • 🚀 Fast & Lightweight

    • Performance-focused architecture
    • Smooth Jetpack Compose UI
    • Optimized resource usage
  • 🔓 Open Source

    • Public source code
    • Open to contributions and improvements

🛠️ Tech Stack

Technology Purpose
Kotlin Primary programming language
Jetpack Compose UI development
Material 3 Expressive UI design system
Room Local database
Retrofit API networking
Kotlin Coroutines Asynchronous operations
Gradle Build system

📥 Installation

Download the latest version from the GitHub Releases page:

👉 Download the latest release


💻 Running in Android Studio

Clone the repository:

git clone https://github.com/mmdparsa-dev/Cheghad.git

Then:

  1. Open the project in Android Studio.
  2. Allow Gradle to sync all required dependencies.
  3. Connect an Android device or start an emulator.
  4. Build and run the application.

🤝 Contributing

Cheghad is an open-source project and contributions are welcome.

If you find a bug or have an idea for improving the project:

  • Open an Issue.
  • Submit a Pull Request.
  • Share your ideas and suggestions.

🖼️ Preview


📄 License

Cheghad is distributed under the MIT License.

See the LICENSE file for more information.


Developed with ❤️ by mmdparsa

⭐ If you like Cheghad, consider giving the repository a star!

About

Cheghad is a fast, lightweight, and open-source Android app for checking live currency rates. Built with Jetpack Compose and Material 3 Expressive, it gives you a super clean, smooth, and modern experience. |چقد یه اپلیکیشن سریع، سبک و متن‌باز اندرویدی برای دیدن لحظه‌ای قیمت ارز و سکه‌ست. با جدیدترین استانداردهای اندروید و متریال ۳ ساخته شده

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages