{"id":23868093,"url":"https://github.com/siddiqui145/shop_cart","last_synced_at":"2026-04-12T10:33:50.153Z","repository":{"id":265631062,"uuid":"895896771","full_name":"Siddiqui145/shop_cart","owner":"Siddiqui145","description":"A feature-rich e-commerce application built using Flutter, designed to showcase products dynamically fetched from an API. The app includes a state management system powered by Riverpod, offering smooth cart and checkout experiences with real-time updates. Dynamic display of products fetched from an API, Add, remove, and modify product quantities.","archived":false,"fork":false,"pushed_at":"2024-12-15T19:12:25.000Z","size":433,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-01T17:40:40.504Z","etag":null,"topics":["dart","flutter","http-requests","provider-state-management","realtime-u","rest-api","shopping-cart"],"latest_commit_sha":null,"homepage":"","language":"C++","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/Siddiqui145.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-11-29T06:18:45.000Z","updated_at":"2024-12-18T18:54:22.000Z","dependencies_parsed_at":"2024-11-30T08:29:11.369Z","dependency_job_id":"eedd33d2-cc18-4fb5-9c93-a3705bb225b9","html_url":"https://github.com/Siddiqui145/shop_cart","commit_stats":null,"previous_names":["siddiqui145/shop_cart"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Siddiqui145/shop_cart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddiqui145%2Fshop_cart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddiqui145%2Fshop_cart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddiqui145%2Fshop_cart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddiqui145%2Fshop_cart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Siddiqui145","download_url":"https://codeload.github.com/Siddiqui145/shop_cart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siddiqui145%2Fshop_cart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269832906,"owners_count":24482334,"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","status":"online","status_checked_at":"2025-08-11T02:00:10.019Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dart","flutter","http-requests","provider-state-management","realtime-u","rest-api","shopping-cart"],"created_at":"2025-01-03T11:17:35.410Z","updated_at":"2025-12-30T21:47:41.725Z","avatar_url":"https://github.com/Siddiqui145.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 Flutter Shop Cart App\n\nA dynamic e-commerce application built with Flutter that showcases products fetched from an API. Users can browse, add products to the cart, manage quantities, and proceed to checkout seamlessly. The app leverages **Riverpod** for state management, ensuring a reactive and scalable architecture.\n\n---\n\n## 🚀 Features\n\n- **Dynamic Product Fetching**: Fetch and display products dynamically from an API.  \n- **State Management**: Powered by **Riverpod** for efficient and maintainable state management.  \n- **Cart Management**:  \n  - Add products to the cart.  \n  - Increase or decrease product quantities directly from the cart page.  \n  - Remove products from the cart with a confirmation dialog.  \n- **Real-Time Price Updates**: The total price updates dynamically based on the cart contents and product quantities.  \n- **Checkout Functionality**: A simple checkout button (dummy implementation for now).\n\n---\n\n## 🛠️ Tech Stack\n\n- **Framework**: Flutter  \n- **State Management**: Riverpod  \n- **API Handling**: HTTP package (or any API client used)  \n- **Design**: Material Design principles  \n\n---\n\n## 📸 Screenshots\n\n1. **Product Listing Page**\n     ![Screenshot_20241130_125310](https://github.com/user-attachments/assets/9efc7290-be03-4580-8603-7ecc38929698)\n\n\n2. **Cart Page with Quantity Management**  \n\n![Screenshot_20241130_125335](https://github.com/user-attachments/assets/3fdda85c-f626-464a-af27-a4b5491cf4d8)\n\n\n## ⚙️ Setup and Installation\n\nFollow these steps to run the project locally:\n\n1. **Clone the Repository**\n   ```bash\n   git clone https://github.com/Siddiqui145/shop_cart.git\n   cd shop_cart\n   ```\n\n2. **Install Dependencies**\n   ```bash\n   flutter pub get\n   ```\n\n3. **Run the App**\n   ```bash\n   flutter run\n   ```\n\n4. **Build for Production**\n   ```bash\n   flutter build apk\n   ```\n\n---\n\n## 🗂️ Project Structure\n\n```\nlib/\n├── api_service.dart            # API client for fetching product data\n├── models/                     # Data models for the application\n│   └── product.dart            # Product model\n├── providers/                  # Riverpod state management providers\n│   └── product_provider.dart   # Providers for product and cart state\n├── screens/                    # UI Screens\n│   ├── product_list_page.dart  # Product listing page\n│   ├── cart_details_page.dart  # Cart page with quantity management\n│   └── splash_screen.dart      # Splash screen\n└── main.dart                   # Entry point of the application\n```\n\n---\n\n## 📂 API Details\n\n### Endpoint Used\n**Base URL**: `https://api.example.com/products`  \n- Fetch products: `GET /products?page=\u003cpage_number\u003e`\n\n---\n\n## 🌟 Key Functionalities\n\n1. **Product Listing**\n   - Products are fetched dynamically from an external API.\n   - Each product displays an image, title, and price.\n\n2. **Cart Management**\n   - **Add to Cart**: Products can be added to the cart from the listing page.  \n   - **Quantity Adjustment**: Users can increase or decrease the quantity of products directly from the cart page.  \n   - **Remove Items**: Users can remove items from the cart with a confirmation dialog.  \n\n3. **Real-Time Updates**\n   - The total cart price updates dynamically based on the product quantities.\n\n4. **Checkout**\n   - A simple checkout button to proceed (dummy implementation).\n\n---\n\n## 🔧 Configuration\n\n### API Integration\nUpdate the **base URL** in `api_service.dart` if needed:\n```dart\nconst String baseUrl = 'https://api.example.com/products';\n```\n\n---\n\n## 🧩 Dependencies\n\n| Package         | Version |\n|------------------|---------|\n| Flutter          | Latest |\n| Flutter Riverpod | Latest |\n| HTTP             | Latest |\n\n---\n\n## 🚧 Known Issues\n\n- Checkout functionality is currently a placeholder.\n- Error handling for API requests can be improved.\n\n---\n\n## 🛠️ Future Enhancements\n\n- Implement real-time checkout functionality.\n- Add user authentication and personalized carts.\n- Improve error handling and offline support.\n\n---\n\n## 🙌 Contribution\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository.  \n2. Create a new branch (`git checkout -b feature-branch`).  \n3. Commit your changes (`git commit -m \"Add feature\"`).  \n4. Push to the branch (`git push origin feature-branch`).  \n5. Open a pull request.\n\n---\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## 🧑‍💻 Author\n\n- **Your Name**: Siddiqui Taha  \n- **Email**: [tahasiddiqui541@gmail.com](mailto:tahasiddiqui541@gmail.com)  \n- **GitHub**: [Siddiqui145](https://github.com/Siddiqui145)\n\n---\n\n### 💡 Happy Coding!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddiqui145%2Fshop_cart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddiqui145%2Fshop_cart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddiqui145%2Fshop_cart/lists"}