{"id":24107473,"url":"https://github.com/hareem-gohar/bokosm-ecom-app","last_synced_at":"2025-08-22T22:20:02.422Z","repository":{"id":249687133,"uuid":"831167372","full_name":"Hareem-Gohar/Bokosm-Ecom-App","owner":"Hareem-Gohar","description":" The E-Commerce Store App is a responsive shopping platform built with React, Vite, and Tailwind CSS. It features product browsing, cart management, and state management with React Context API and useReducer, offering a smooth, multi-page user experience.","archived":false,"fork":false,"pushed_at":"2024-11-10T16:20:08.000Z","size":4931,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-10T22:40:01.641Z","etag":null,"topics":["axios-react","context-api","custom-hook","react-router-dom","useeffect-hook","useparams-hook","usereducer","usestate-hook"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hareem-Gohar.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-07-19T20:31:07.000Z","updated_at":"2024-12-21T19:54:45.000Z","dependencies_parsed_at":"2024-09-10T20:45:02.345Z","dependency_job_id":"910c9014-045a-48d7-a1ee-3a2a1fe34b53","html_url":"https://github.com/Hareem-Gohar/Bokosm-Ecom-App","commit_stats":null,"previous_names":["hareem-gohar/e-commerce-store-app","hareem-gohar/bokosm-ecom-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hareem-Gohar%2FBokosm-Ecom-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hareem-Gohar%2FBokosm-Ecom-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hareem-Gohar%2FBokosm-Ecom-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hareem-Gohar%2FBokosm-Ecom-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hareem-Gohar","download_url":"https://codeload.github.com/Hareem-Gohar/Bokosm-Ecom-App/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241086863,"owners_count":19907350,"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":["axios-react","context-api","custom-hook","react-router-dom","useeffect-hook","useparams-hook","usereducer","usestate-hook"],"created_at":"2025-01-10T22:38:00.681Z","updated_at":"2025-02-28T01:52:37.521Z","avatar_url":"https://github.com/Hareem-Gohar.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# E-Commerce Store App\n\nAn E-Commerce Store application built using **React**, **Vite**, **Tailwind CSS**, and **React Router**. This project demonstrates the development of a fully functional e-commerce platform, featuring product browsing, cart management, and global state management with **React Context API** and **useReducer**. It is designed to be responsive, ensuring a great user experience across devices.\n\n## Features\n\n- **Product Listing**: Browse and view product details.\n- **Shopping Cart**: Add and remove items from the cart, view total price.\n- **State Management**: Centralized global state management using React Context and `useReducer`.\n- **Responsive Design**: Tailwind CSS ensures that the app works seamlessly on all screen sizes.\n- **React Router**: Multi-page navigation for different sections like Home, Product Details, and Cart.\n- **Product Filtering**: Sort and filter products based on different criteria (optional feature).\n\n## Tech Stack\n\n- **Frontend**: \n  - **React**: JavaScript library for building user interfaces.\n  - **Vite**: Next-generation, fast development server and bundler for React.\n  - **React Router**: Declarative routing for single-page applications.\n  - **Tailwind CSS**: Utility-first CSS framework for designing custom and responsive UI components.\n  \n- **State Management**:\n  - **Context API**: React's built-in method to share state globally without prop-drilling.\n  - **useReducer**: A React hook for managing complex state logic.\n\n- **Others**:\n  - **Axios**: Promise-based HTTP client for making API requests.\n\n## Getting Started\n\n### Prerequisites\n\n- **Node.js** (\u003e=14.x)\n- **npm** or **yarn**\n\n### Installation\n\n1. Clone the repository to your local machine:\n    ```bash\n    git clone https://github.com/Hareem-Gohar/E-Commerce-Store-App.git\n    ```\n\n2. Navigate into the project folder:\n    ```bash\n    cd E-Commerce-Store-App\n    ```\n\n3. Install the required dependencies:\n    ```bash\n    npm install\n    ```\n\n4. Run the app locally:\n    ```bash\n    npm run dev\n    ```\n\n   The app will now be accessible at `http://localhost:3000` in your browser.\n\n## Usage\n\nOnce the app is up and running, users can:\n\n- **Browse Products**: View a list of available products.\n- **View Product Details**: Click on a product to view more information.\n- **Add to Cart**: Add items to the shopping cart and proceed to checkout.\n- **Manage Cart**: View items in the cart, remove them, or update the quantity.\n- **Responsive Design**: The app automatically adjusts to different screen sizes, ensuring usability on mobile and desktop devices.\n\n## Acknowledgments\n\n- Tailwind CSS for the fantastic utility-first framework.\n- React Router for efficient routing.\n- React Context API and `useReducer` for managing global state in a React app.\n- Axios for handling API requests.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhareem-gohar%2Fbokosm-ecom-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhareem-gohar%2Fbokosm-ecom-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhareem-gohar%2Fbokosm-ecom-app/lists"}