• User Authentication - Secure login and registration system
• Product Catalog - Browse products with categories, colors, and sizes
• Shopping Cart - Add/remove items with real-time updates
• Payment Processing - Secure payment gateway integration
• Order Management - Track orders and view invoices
• User Profile - Manage personal information and preferences

• Modern UI/UX - Built with Material Design 3 principles
• Responsive Design - Optimized for all screen sizes
• Smooth Navigation - Intuitive app flow with bottom navigation
• Dark/Light Theme - Adaptive theming system
• Edge-to-Edge Design - Immersive full-screen experience

• MVVM Architecture - Clean separation of concerns
• Dependency Injection - Hilt for efficient dependency management
• Local Database - Room database for offline data persistence
• API Integration - Retrofit for seamless backend communication
• Image Loading - Glide for efficient image management
• Navigation - Jetpack Navigation Compose for smooth transitions

app/
├── 📁 api/           # API interfaces and network layer
├── 📁 config/        # Application configuration
├── 📁 db/           # Room database and DAOs
├── 📁 models/       # Data models and entities
├── 📁 modules/      # Hilt modules for DI
├── 📁 repositories/ # Data repositories
├── 📁 ui/          # UI components and screens
│   ├── components/  # Reusable UI components
│   ├── screens/     # App screens
│   └── theme/       # App theming
├── 📁 utils/        # Utility classes
└── 📁 viewmodels/   # ViewModels for UI logic

• Android Studio Hedgehog (2023.1.1) or later
• Android SDK 36 (Android 14)
• Minimum SDK: API 21 (Android 5.0)
• Java 17 or later

1. Clone the repository

   git clone https://github.com/mahdizaredev/OnlineShopApplication.git
   cd OnlineShopApplication

2. Open in Android Studio

   • Launch Android Studio
   • Open the project folder
   • Wait for Gradle sync to complete

3. Build and Run

   • Connect an Android device or start an emulator
   • Click the "Run" button or press Shift + F10
   • Select your target device and wait for the app to install

• Debug - Development build with debugging enabled
• Release - Production build with ProGuard optimization

The app is configured to work with the online shop backend at onlineshopholosen.ir. Make sure you have:

• Internet connectivity
• Valid API endpoints configured
• Proper authentication credentials

• Modify app/src/main/res/values/ for app branding
• Update app/src/main/java/com/mahdizaredev/onlineshop/config/ for API configuration
• Customize themes in app/src/main/java/com/mahdizaredev/onlineshop/ui/theme/

• Multi-ABI Support - Optimized for x86, x86_64, ARM, and ARM64
• Universal APK - Single APK for all architectures
• ProGuard Optimization - Code shrinking and obfuscation
• Resource Optimization - Efficient resource management
• Memory Management - Optimized image loading and caching

The project includes comprehensive testing setup:

• Unit Tests - JUnit 4 for business logic
• UI Tests - Espresso for UI automation
• Compose Tests - Compose testing framework
• Instrumentation Tests - Android device testing

Run tests with:

# Unit tests
./gradlew test

# Instrumented tests
./gradlew connectedAndroidTest

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• Follow Kotlin coding conventions
• Use meaningful commit messages
• Add tests for new functionality
• Update documentation as needed
• Follow Material Design principles

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

Mahdi Zare - Lead Android Developer