🛒 E-Commerce Android Application

A modern, full-featured e-commerce Android application built with Jetpack Compose, Firebase, and following Clean Architecture principles with MVVM pattern.

📱 Features

✅ Core Features

User Authentication
- Email/Password registration and login
- Secure Firebase Authentication
- Password validation and error handling
- Session management
Product Management
- Upload products with multiple images (minimum 3) "due to some charges of firebase i cant use storage"
- View all products in a scrollable list
- Search products by title, description, or category
- Filter products by category
- Real-time product updates
Product Details
- View complete product information
- Image gallery with swipe navigation
- Seller contact information
- Add/Remove from favorites
- Back navigation
Favorites System
- Add products to favorites
- Local storage using Room Database
- Persistent across app sessions
- Remove from favorites
- View all saved favorites
Upload Products
- Multi-image picker (up to 5 images)
- Image preview with remove option
- Form validation
- Category selection
- Price and description fields
- Upload progress indicator

🎁 Bonus Features

Recommended Products - Integrated FakeStore API for product recommendations
Pull-to-Refresh - Refresh product listings
Search Functionality - Real-time product search
Category Filters - Filter by product categories
Shimmer Loading - Skeleton loading placeholders
Empty States - User-friendly empty state designs
Error Handling - Comprehensive error handling with retry options

🏗️ Architecture & Design Patterns

Clean Architecture

Presentation Layer (UI)
    ↓
Domain Layer (Use Cases)
    ↓
Data Layer (Repositories)
    ↓
Data Sources (Remote/Local)

MVVM (Model-View-ViewModel)

Model: Data classes and business logic
View: Composable UI components
ViewModel: UI state management and business logic

Dependency Injection

Hilt/Dagger: Provides compile-time dependency injection
Modular architecture with separate modules for different concerns

🛠️ Tech Stack

Core Technologies

Language: Kotlin 1.9.20
Minimum SDK: API 24 (Android 7.0)
Target SDK: API 34 (Android 14)
Build System: Gradle (Kotlin DSL)

UI Framework

Jetpack Compose: Modern declarative UI toolkit
Material Design 3: Latest Material Design components
Coil: Image loading and caching
Navigation Compose: Type-safe navigation

Backend & Database

Firebase Authentication: User authentication
Firebase Firestore: Real-time NoSQL database
Firebase Storage: Image and file storage
Room Database: Local SQLite database for favorites

Networking

Retrofit: REST API client
OkHttp: HTTP client with logging interceptor
Gson: JSON serialization/deserialization

Dependency Injection

Hilt: Dependency injection framework
Dagger: Compile-time dependency injection

Coroutines & Flow

Kotlin Coroutines: Asynchronous programming
Kotlin Flow: Reactive data streams
StateFlow: UI state management

📂 Project Structure

com.example.ecommerce/
│
├── data/
│   ├── local/
│   │   ├── dao/                    # Room DAOs
│   │   ├── database/               # Room Database
│   │   └── entity/                 # Room Entities
│   ├── remote/
│   │   ├── api/                    # Retrofit API interfaces
│   │   ├── firebase/               # Firebase managers
│   │   └── model/                  # Data models
│   └── repository/                 # Repository implementations
│
├── di/                             # Dependency Injection modules
│   ├── AppModule.kt
│   ├── DatabaseModule.kt
│   ├── NetworkModule.kt
│   └── RepositoryModule.kt
│
├── ui/
│   ├── auth/                       # Login & Registration
│   ├── home/                       # Home screen with products
│   ├── productdetail/              # Product details
│   ├── upload/                     # Upload products
│   ├── favorites/                  # Favorites screen
│   ├── components/                 # Reusable UI components
│   ├── navigation/                 # Navigation setup
│   └── theme/                      # App theming
│
├── util/                           # Utility classes
│   ├── Constants.kt
│   └── Resource.kt                 # Sealed class for API states
│
├── MainActivity.kt                 # Entry point
└── ECommerceApplication.kt         # Application class

🚀 Getting Started

Prerequisites

Android Studio Hedgehog (2025.2.1) or newer
JDK 17 or higher
Android SDK (API 24+)
Firebase account
Internet connection

Installation Steps

1. Clone the Repository

git clone https://github.com/yourusername/ecommerce-android.git
cd ecommerce-android

2. Setup Firebase

a. Create Firebase Project

Go to Firebase Console
Click "Add Project"
Enter project name and follow setup wizard

b. Add Android App

Click Android icon in Firebase project
Register app with package name: com.example.ecommerce
Download google-services.json
Place file in app/ directory

c. Enable Firebase Services

Authentication:

Go to Authentication → Sign-in method
Enable Email/Password
Save

Firestore:

Go to Firestore Database → Create database
Start in test mode
Update rules:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read: if request.auth != null;
      allow write: if request.auth != null && request.auth.uid == userId;
    }
    
    match /products/{productId} {
      allow read: if request.auth != null;
      allow create: if request.auth != null;
      allow update, delete: if request.auth != null && 
        request.auth.uid == resource.data.uploaderId;
    }
  }
}

Storage:

Go to Storage → Get Started
Update rules:

rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /product_images/{allPaths=**} {
      allow read: if true;
      allow write: if request.auth != null;
    }
  }
}

3. Open in Android Studio

Open Android Studio
File → Open → Select project folder
Wait for Gradle sync

4. Build and Run

Connect device or start emulator
Click Run ▶️ button
Wait for app to install
App should launch successfully

🎨 Screenshots

Authentication

Login	Register

Main Features

Home	Product Detail	Upload

Additional Features

Favorites	Search	Filter

📦 Dependencies

Build Configuration

dependencies {
    // Core Android
    implementation("androidx.core:core-ktx:1.12.0")
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")
    implementation("androidx.activity:activity-compose:1.8.1")

    // Compose
    implementation(platform("androidx.compose:compose-bom:2023.10.01"))
    implementation("androidx.compose.ui:ui")
    implementation("androidx.compose.material3:material3")
    implementation("androidx.navigation:navigation-compose:2.7.5")

    // Hilt
    implementation("com.google.dagger:hilt-android:2.48")
    kapt("com.google.dagger:hilt-android-compiler:2.48")
    implementation("androidx.hilt:hilt-navigation-compose:1.1.0")

    // Room
    implementation("androidx.room:room-runtime:2.6.0")
    implementation("androidx.room:room-ktx:2.6.0")
    kapt("androidx.room:room-compiler:2.6.0")

    // Firebase
    implementation(platform("com.google.firebase:firebase-bom:32.7.0"))
    implementation("com.google.firebase:firebase-auth-ktx")
    implementation("com.google.firebase:firebase-firestore-ktx")
    implementation("com.google.firebase:firebase-storage-ktx")

    // Retrofit
    implementation("com.squareup.retrofit2:retrofit:2.9.0")
    implementation("com.squareup.retrofit2:converter-gson:2.9.0")

    // Coil
    implementation("io.coil-kt:coil-compose:2.5.0")

    // Coroutines
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-play-services:1.7.3")
}

🧪 Testing

Unit Tests

Located in app/src/test/

Run tests:

./gradlew test

UI Tests

Located in app/src/androidTest/

Run UI tests:

./gradlew connectedAndroidTest

🐛 Troubleshooting

Common Issues

Issue 1: Build Fails

Solution: 
- File → Invalidate Caches → Restart
- Check google-services.json is in app/ folder
- Verify internet connection

Issue 2: App Crashes on Launch

Solution:
- Check @HiltAndroidApp is on Application class
- Check @AndroidEntryPoint is on MainActivity
- Verify AndroidManifest references .ECommerceApplication

Issue 3: Upload Fails

Solution:
- Update Firebase Storage rules
- Check user is logged in
- Verify internet connection

Issue 4: Can't Click Products

Solution:
- Verify ProductCard has .clickable(onClick = onClick)
- Check NavGraph has ProductDetail route
- Rebuild project

📝 API Documentation

FakeStore API

External API for recommended products: https://fakestoreapi.com/

Endpoint:

GET https://fakestoreapi.com/products

Response:

[
  {
    "id": 1,
    "title": "Product Name",
    "price": 109.95,
    "description": "Product description",
    "category": "electronics",
    "image": "https://...",
    "rating": {
      "rate": 3.9,
      "count": 120
    }
  }
]

🔐 Security

Best Practices Implemented

✅ Firebase Authentication for user management
✅ Firestore Security Rules for data protection
✅ Storage Rules for file access control
✅ Input validation on all forms
✅ Secure password handling (minimum 6 characters)
✅ No hardcoded API keys (using google-services.json)

Recommended Production Changes

Implement email verification
Add password strength requirements
Implement rate limiting
Add user roles and permissions
Enable App Check for Firebase
Implement proper error logging (Crashlytics)

🚀 Future Enhancements

Planned Features

👥 Contributing

Contributions are welcome! Please follow these steps:

Fork the project
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Code Style

Follow Kotlin Coding Conventions
Use meaningful variable and function names
Add comments for complex logic
Write unit tests for new features

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2024 Your Name

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

👨‍💻 Author

Satya prakash verma

🙏 Acknowledgments

Firebase - Backend services
Jetpack Compose - UI Framework
Material Design 3 - Design system
FakeStore API - Recommended products
Coil - Image loading
Hilt - Dependency injection

📊 Project Stats

Total Files: 50+
Lines of Code: 5000+
Screens: 6 main screens
Components: 15+ reusable components
Development Time: 40+ hours
Last Updated: november 2025

📞 Support

If you have any questions or issues:

Check the Troubleshooting section
Search existing issues
Create a new issue
Email:satya766744@gmail.com

⭐ Star History

If you find this project useful, please consider giving it a star! ⭐

🎓 Learning Resources

📱 Download

APK Releases

Coming soon! Check the Releases page.

Google Play Store

Coming soon!

Made with ❤️ using Kotlin and Jetpack Compose

⭐ If you like this project, please give it a star! ⭐

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.idea		.idea
app		app
gradle		gradle
.gitignore		.gitignore
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle.kts		settings.gradle.kts

Folders and files

Latest commit

History

Repository files navigation

🛒 E-Commerce Android Application

📱 Features

✅ Core Features

🎁 Bonus Features

🏗️ Architecture & Design Patterns

Clean Architecture

MVVM (Model-View-ViewModel)

Dependency Injection

🛠️ Tech Stack

Core Technologies

UI Framework

Backend & Database

Networking

Dependency Injection

Coroutines & Flow

📂 Project Structure

🚀 Getting Started

Prerequisites

Installation Steps

1. Clone the Repository

2. Setup Firebase

3. Open in Android Studio

4. Build and Run

🎨 Screenshots

Authentication

Main Features

Additional Features

📦 Dependencies

Build Configuration

🧪 Testing

Unit Tests

UI Tests

🐛 Troubleshooting

Common Issues

📝 API Documentation

FakeStore API

🔐 Security

Best Practices Implemented

Recommended Production Changes

🚀 Future Enhancements

Planned Features

👥 Contributing

Code Style

📄 License

👨‍💻 Author

🙏 Acknowledgments

📊 Project Stats

📞 Support

⭐ Star History

🎓 Learning Resources

Recommended Tutorials

📱 Download

APK Releases

Google Play Store

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages