Skip to content

A clone of Instagram's explore page built with Jetpack Compose for Android. It displays photos in a responsive grid, handles network connectivity states, and supports infinite scrolling with Lottie animations for loading and error states. Features photo fetching with pagination and retry options.

License

Notifications You must be signed in to change notification settings

SomayeKhaleghi/InstaExploreJetpack

 
 

Repository files navigation

InstaExploreJetpack 📸✨

📱 A modern Instagram-like Explore screen built with Jetpack Compose, animations, and real API data.
📱 رابط کاربری مدرن شبیه بخش Explore اینستاگرام با استفاده از Jetpack Compose، انیمیشن و داده‌های واقعی API.


🔹 Features | ویژگی‌ها

  • Instagram-style dynamic grid layout
    گرید پویا و نامتقارن مشابه اینستاگرام
  • Asymmetric image positioning
    جای‌گذاری نامنظم تصاویر برای جذابیت بصری
  • Lottie animations for loading & errors
    انیمیشن‌های Lottie برای وضعیت بارگذاری و خطا
  • Retrofit + Gson for real data fetching
    استفاده از Retrofit و Gson برای دریافت داده واقعی
  • Coil for fast and efficient image loading
    بارگذاری سریع تصاویر با Coil
  • Jetpack Compose + Material 3 design
    طراحی مدرن با Jetpack Compose و متریال دیزاین ۳
  • Dark/Light mode supported
    پشتیبانی از حالت تاریک و روشن
  • Offline detection with NetworkCallback
    تشخیص آفلاین بودن کاربر با NetworkCallback

📸 Preview | پیش‌نمایش

Screenshot 1 Screenshot 2
Preview 1 Preview 2

🧰 Tech Stack | تکنولوژی‌ها

  • Kotlin
  • Jetpack Compose
  • Material 3
  • Navigation Compose
  • Retrofit + Gson
  • Coil
  • Lottie Compose
  • Accompanist System UI Controller
  • Coroutines + Flow

🚀 How to Run | نحوه اجرا

git clone https://github.com/mr-coder20/InstaExploreJetpack.git
Requirements | نیازمندی‌ها:
Android Studio Hedgehog یا جدیدتر

Minimum SDK: 24

Target SDK: 36

اتصال اینترنت برای دریافت داده و تصویر

Steps | مراحل:
پروژه را با Android Studio باز کنید

صبر کنید تا Gradle sync کامل شود

یک شبیه‌ساز یا دستگاه واقعی انتخاب کنید

Run بزنید و از زیبایی صفحه Explore لذت ببرید 🎉

📝 License | مجوز
This project is licensed under the MIT License.
این پروژه تحت مجوز MIT منتشر شده است.

👤 Author | سازنده
Made with ❤️ by @mr-coder20
ساخته شده با عشق توسط @mr-coder20



main

About

A clone of Instagram's explore page built with Jetpack Compose for Android. It displays photos in a responsive grid, handles network connectivity states, and supports infinite scrolling with Lottie animations for loading and error states. Features photo fetching with pagination and retry options.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 100.0%