Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/felixojiambo/e-shopfrontend

An online shopping for diverse groups of people
https://github.com/felixojiambo/e-shopfrontend

Last synced: about 2 months ago
JSON representation

An online shopping for diverse groups of people

Awesome Lists containing this project

README

        

```markdown
# E-commerce React Application

This repository contains the frontend code for an e-commerce application built with React.js. The application allows users to browse products, add items to their cart, and manage their account. It uses a backend API for data management and authentication.

## Features

- **Product Browsing**: View new collections, popular products, and related products.
- **User Authentication**: Register, login, and manage user sessions.
- **Cart Management**: Add items to cart, view cart data, and remove items from cart.
- **Navigation**: Navigate between different sections of the e-commerce site.
- **Newsletter Subscription**: Subscribe to receive exclusive offers via email.
- **Exclusive Offers**: View exclusive offers from Nairobi's best sellers.

## Getting Started

1. **Clone the Repository**: Clone this repository to your local machine.

```bash
git clone
```

2. **Install Dependencies**: Navigate to the project directory and install the required dependencies.

```bash
npm install
```

3. **Start the Application**: Run the application.

```bash
npm start
```

The application will start in development mode.

## Components

- **App**: The main component that wraps the entire application, including routing and navigation.
- **ShopContextProvider**: Provides global state management for products, cart items, and user authentication.
- **LoginSignUp**: Handles user login and registration.
- **NewCollections**: Displays new collections of products.
- **Popular**: Shows popular products in the women category.
- **Navbar**: Navigation bar for the application.
- **CartItems**: Displays items in the user's cart.
- **Hero**: Hero section for showcasing new arrivals.
- **DescriptionBox**: Displays product descriptions and reviews.
- **Footer**: Footer component with links and social media icons.
- **Breadcrum**: Breadcrumb navigation for product pages.
- **Offers**: Section for exclusive offers.
- **NewsLetter**: Newsletter subscription form.
- **RelatedProducts**: Displays related products for a given product.
- **Product**: Component for displaying a single product's details.

## Technologies Used

- **React.js**: JavaScript library for building user interfaces.
- **Context API**: For state management across the application.
- **Fetch API**: For making HTTP requests to the backend.
- **LocalStorage**: For storing user authentication tokens.
- **React Router**: For routing and navigation within the application.

## Contributing

Contributions are welcome. Please feel free to submit a pull request or open an issue.

## License

This project is licensed under the MIT License.
```