{"id":20027969,"url":"https://github.com/mohamedelareeg/plugi","last_synced_at":"2026-05-01T20:32:26.064Z","repository":{"id":214954435,"uuid":"626653172","full_name":"mohamedelareeg/Plugi","owner":"mohamedelareeg","description":"Plugi is your go-to Android app for bidding on auctions and shopping online. With features like real-time bidding, swipe-to-refresh, and Google Maps integration, it offers a seamless shopping experience.","archived":false,"fork":false,"pushed_at":"2024-03-02T16:26:21.000Z","size":11683,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-12T17:27:34.274Z","etag":null,"topics":["android","android-application","bidding","firebase","firebase-realtime-database","java","online-shop","rating","store"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mohamedelareeg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-11T22:44:05.000Z","updated_at":"2024-12-24T10:06:29.000Z","dependencies_parsed_at":"2024-03-02T17:42:37.138Z","dependency_job_id":null,"html_url":"https://github.com/mohamedelareeg/Plugi","commit_stats":null,"previous_names":["mohamedelareeg/plugi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelareeg%2FPlugi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelareeg%2FPlugi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelareeg%2FPlugi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mohamedelareeg%2FPlugi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mohamedelareeg","download_url":"https://codeload.github.com/mohamedelareeg/Plugi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241460042,"owners_count":19966516,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-application","bidding","firebase","firebase-realtime-database","java","online-shop","rating","store"],"created_at":"2024-11-13T09:12:43.574Z","updated_at":"2026-05-01T20:32:26.018Z","avatar_url":"https://github.com/mohamedelareeg.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plugi - Bidding and Online Store App\n\nPlugi is an Android application that provides a platform for bidding and online shopping for various items including clothes, boots, and more.\n\n## Table of Contents\n\n- [Features](#features)\n- [Getting Started](#getting-started)\n  - [Prerequisites](#prerequisites)\n  - [Installation](#installation)\n  - [Configuration](#configuration)\n- [Running the Application](#running-the-application)\n  - [Debugging](#debugging)\n  - [Release Build](#release-build)\n- [Built With](#built-with)\n- [Dependencies](#dependencies)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Bidding System:** Participate in auctions and place bids on your favorite items.\n- **Online Store:** Browse and shop for a variety of products including clothes and boots.\n- **Swipe to Refresh:** Pull-to-refresh functionality for an enhanced user experience.\n- **Rating System:** Rate and review products using the integrated rating bar.\n- **Real-time Communication:** Utilizes socket.io for real-time communication.\n- **Maps Integration:** Integrates Google Maps and Places API for location-based features.\n- **Firebase Analytics and Messaging:** Utilizes Firebase for analytics and push notifications.\n## Home Page\n\n![Home Page](3_Home.png)\n\n## Product Details\n\n![Product Details](5_ProductDetail.png)\n\n\n## Getting Started\n\n### Prerequisites\n\n- Android Studio\n- Android device or emulator\n\n### Installation\n\n1. Clone the repository: `git clone https://github.com/mohamedelareeg/Plugi.git`\n2. Open the project in Android Studio.\n3. Build the project to resolve dependencies and compile the application.\n4. Connect an Android device or use an emulator.\n5. Run the application from Android Studio.\n\n### Configuration\n\nEnsure you have the required API keys and configurations for Firebase services. Update the necessary files with your configurations.\n\n## Running the Application\n\n### Debugging\n\nTo run the application in debug mode:\n\n1. Connect an Android device or use an emulator.\n2. In Android Studio, select \"Run\" from the toolbar.\n3. Choose the connected device/emulator and click \"OK\" to build and run the app.\n\n### Release Build\n\nTo build a release version of the application:\n\n1. Open the terminal in Android Studio.\n2. Navigate to the project root directory.\n3. Run the following command:\n\n   ```bash\n   ./gradlew assembleRelease\n   \nThis command generates the release APK in the app/build/outputs/apk/release/ directory.\n\n### Publishing\nTo publish the application to the Google Play Store:\n\n1. gnerate a signing configuration for the release build in the app/build.gradle file.\n2. Build the release version using the steps mentioned above.\n3. In Android Studio, select \"Build\" \u003e \"Build Bundle(s) / APK(s)\" \u003e \"Build APK(s)\".\n4. The generated APK will be available in the app/build/outputs/apk/release/ directory.\n\nFollow the Play Console guidelines to create a new release, upload the APK, and publish the app.\n\n## Built With\n\n- [Java](https://www.java.com/) - The primary programming language.\n- [Firebase](https://firebase.google.com/) - Comprehensive mobile and web app development platform.\n- [Socket.IO](https://socket.io/) - Real-time bidirectional event-based communication.\n- [Retrofit](https://square.github.io/retrofit/) - Type-safe HTTP client for Android and Java.\n- [Glide](https://github.com/bumptech/glide) - Fast and efficient image loading library.\n- [PageIndicatorView](https://github.com/romandanylyk/PageIndicatorView) - Page indicator for ViewPager.\n- [SimpleRatingBar](https://github.com/ome450901/SimpleRatingBar) - Rating bar library.\n- [Kotlin Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) - Asynchronous programming in Kotlin.\n- [Material Calendar View](https://github.com/Applandeo/Material-Calendar-View) - Material Design calendar view.\n- [CountdownView](https://github.com/iwgang/CountdownView) - Countdown timer library.\n- [Flexbox Layout](https://github.com/google/flexbox-layout) - Flexible box layout.\n- [CircularCountdown](https://github.com/douglasspgyn/CircularCountdown) - Circular countdown timer.\n- [AutoImageSlider](https://github.com/smarteist/Android-Image-Slider) - Auto image slider.\n- [MaterialSearchBar](https://github.com/mancj/MaterialSearchBar) - Material Design search bar.\n- [EventBus](https://greenrobot.org/eventbus/) - Event bus library.\n- [SwitchButton](https://github.com/kyleduo/SwitchButton) - Switch button library.\n\n## Dependencies\n\nDetailed information about the libraries and dependencies used in the project can be found in the [build.gradle](build.gradle) file.\n\n## Contributing\n\nFeel free to contribute to the development of Plugi by creating issues, submitting pull requests, or suggesting new features.\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelareeg%2Fplugi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmohamedelareeg%2Fplugi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmohamedelareeg%2Fplugi/lists"}