Discover, Shop, and Manage Seamlessly with Jetpack Compose!
Bazaaro is an e-commerce Android application built using modern Android development practices, including Jetpack Compose, Hilt for dependency injection, Retrofit for networking, and Room for local data storage. The app allows users to browse products, add them to their cart, manage favorites, and view product details.
| Home Screen | Product Details | Cart Management |
|---|---|---|
 |
 |
 |
- Modern Architecture: MVVM with Clean Architecture principles
- Reactive UI: Full Jetpack Compose implementation
- Data Sync: Automatic DB ↔ API synchronization
- Network Monitoring: Integrated Chucker debug tool
- Smart Product Browsing: Explore products by category with dynamic filtering
- Interactive Cart System: Real-time quantity adjustment & multi-item management
- Favorites Hub: Save/unsave items with persistent local storage
- Product Details: Detailed view of each product, including images, descriptions, and ratings.
- Intuitive Navigation: Bottom bar + nested navigation flows
- Error Recovery: Graceful error states with retry capabilities
- Lottie Animations: Smooth loading states and micro-interactions
- Multilingual Support: In-app language change functionality for seamless user experience
- Per-App Language Preferences: Android 13 (API 33) support for personalized app language settings
| Category | Technologies |
|---|---|
| UI | Jetpack Compose • Material 3 • Lottie • Coil |
| Architecture | MVVM • Repository Pattern • State Management w/ Flow & StateFlow |
| DI | Hilt |
| Networking | Retrofit 2 • Moshi • Chucker (Debug) • OkHttp Interceptors |
| Persistence | Room Database |
| Async | Kotlin Coroutines • Flow |
The project is structured into several packages:
- app: Contains the main application components, including the
MainActivity,Appclass, and navigation components. - data: Contains data-related components, including API services, database entities, and repositories.
- presentation: Contains UI-related components, including screens, view models, and state management.
To get started with the project, follow these steps:
-
Clone the repository:
git clone https://github.com/Hedayatpour2002/bazaaro.git
-
Open the project in Android Studio:
- Open Android Studio and select "Open an Existing Project".
- Navigate to the cloned repository and select the
build.gradle.ktsfile.
-
Build the project:
- Sync the project with Gradle files.
- Build the project to ensure all dependencies are resolved.
-
Run the app:
- Connect an Android device or start an emulator.
- Click the "Run" button in Android Studio to launch the app.
- Fork the Project
- Create your Feature Branch:
git checkout -b feature/amazing-feature - Commit Changes:
git commit -m 'Add some amazing feature' - Push to Branch:
git push origin feature/amazing-feature - Open Pull Request
This project is licensed under the MIT License. See the LICENSE file for details.
- Fake Store API for mock data
- Android Developer Community for best practices
- JetBrains for Kotlin language support
Thank you for checking out Bazaaro! If you have any questions or feedback, feel free to reach out. Happy coding! 🚀