This Android application is a hyperlocal marketplace that connects users with nearby shops and their products. The app follows MVVM architecture and provides both demo and live modes.
- Clean, professional UI design similar to Myntra
- 20 pre-loaded demo shops with details and banners
- 100 electronics products with specifications, prices, and images
- Location-based shop sorting
- Firebase authentication (email/password, Google, Apple)
- AWS S3 media handling
- Demo/Live mode toggle in settings
- Catalog search for shop owners
The app follows MVVM (Model-View-ViewModel) architecture with clean separation of concerns:
- Model: Data classes and repositories
- View: Activities and Fragments
- ViewModel: Business logic and state management
The app can operate in two modes:
- Uses pre-loaded data (20 shops, 100 products)
- Works offline without backend connection
- Great for testing and demonstration
- Connects to the backend APIs
- Fetches real-time data from the server
- Requires internet connection
You can toggle between these modes in the Settings screen.
- Clone the repository
- Open the project in Android Studio
- Configure Firebase (add your google-services.json)
- Configure AWS S3 credentials in the build.gradle file
- Build and run the app
This app is designed to work with the following backend:
- Backend: https://github.com/Vivek8968/hyperlocalbymanus.git
- Frontend: https://github.com/Vivek8968/localmarket-frontend.git
No changes to the backend or frontend are required.
The app includes comprehensive testing utilities:
- Core functionality tests
- UI tests
- Authentication and media tests
You can run tests from the menu in the app.
This project is proprietary and confidential.