https://github.com/mr-coder20/instaexplorejetpack

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.
https://github.com/mr-coder20/instaexplorejetpack

android android-app android-studio compose-ui instagram-clone jetpack jetpack-compose kotlin material3 modern-ui ui-clone

Last synced: 3 months ago
JSON representation

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.

• Host: GitHub
• URL: https://github.com/mr-coder20/instaexplorejetpack
• Owner: mr-coder20
• License: mit
• Created: 2025-04-09T17:10:45.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-06-29T18:18:27.000Z (3 months ago)
• Last Synced: 2025-06-29T19:20:57.697Z (3 months ago)
• Topics: android, android-app, android-studio, compose-ui, instagram-clone, jetpack, jetpack-compose, kotlin, material3, modern-ui, ui-clone
• Language: Kotlin
• Homepage:
• Size: 74.5 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 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](explore%20image%201.png) | ![Preview 2](explore%20image2.png) |

---

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

- Kotlin

- Jetpack Compose

- Material 3

- Navigation Compose

- Retrofit + Gson

- Coil

- Lottie Compose

- Accompanist System UI Controller

- Coroutines + Flow

---

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

```bash

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