https://github.com/elyse502/ecommerce-app
Full Stack E-commerce Website
https://github.com/elyse502/ecommerce-app
back-end-development express front-end-development full-stack mern-stack-development mongodb node react
Last synced: about 2 months ago
JSON representation
Full Stack E-commerce Website
- Host: GitHub
- URL: https://github.com/elyse502/ecommerce-app
- Owner: elyse502
- License: mit
- Created: 2024-10-23T11:04:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-24T13:06:28.000Z (9 months ago)
- Last Synced: 2026-01-03T16:18:11.317Z (5 months ago)
- Topics: back-end-development, express, front-end-development, full-stack, mern-stack-development, mongodb, node, react
- Language: JavaScript
- Homepage: https://forever-frontend-delta-five.vercel.app
- Size: 8.41 MB
- Stars: 6
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# E-Commerce App 🛒
This **E-Commerce App** is a full-stack web application that enables users to explore a variety of products, filter them based on specific attributes, and add items to their cart by selecting desired variants like size. Users can place orders by providing delivery addresses and selecting their preferred payment method—either **Cash on Delivery (COD)** or **Online Payment**. The application integrates `Stripe` as the online payment gateway, ensuring secure and seamless transactions.
Additionally, an **Admin Dashboard** is included, where administrators can manage the store by uploading new products, deleting existing ones, and viewing all products listed in the store.
## DEMO 🌐
**UI** Live 👉 [LINK](https://forever-frontend-delta-five.vercel.app)
**Admin Dashboard** 👉 [LINK](https://forever-admin-jet.vercel.app)
# Table of Contents 📜
[Key-Features](#key-features)
[Technologies-Used](#technologies-used)
[Installation-and-Setup](#installation-and-setup)
[Screenshots](#screenshots)
[Future-Enhancements](#future-enhancements)
[Contribution](#contribution)
[License](#license)
## Key-Features
### For Users:
* **Product Exploration**: Browse a variety of products and filter them by category, size, and other attributes.
* **Cart Management**: Add, view, and modify products in the cart.
* **Order Placement**: Provide delivery addresses and select payment methods (COD or online payment via Stripe).
* **Secure Payments**: Stripe integration for secure online payments.
### For Admins:
* **Product Management**: Add, edit, or delete products.
* **Order Monitoring**: View orders placed by users.
* **Inventory Overview**: Access all products listed in the store.
## Technologies-Used
This project is built using the `MERN Stack` (MongoDB, Express.js, React.js, and Node.js), ensuring a robust, scalable, and modern web application.
* **Frontend**: React.js for building a responsive and interactive user interface.
* **Backend**: Node.js and Express.js for API development.
* **Database**: MongoDB for storing user, product, and order data.
* **Payment Gateway**: Stripe for secure online transactions.
## Installation-and-Setup
1. Clone the repository:
```console
git clone https://github.com/elyse502/ecommerce-app.git
cd ecommerce-app
```
2. Install dependencies for both client and server:
```console
cd backend
npm install
cd frontend
npm install
cd admin
npm install
```
3. Create an `.env` file in the root directory for server-side configuration and add the following:
```console
MONGO_URI="your_mongodb_connection_string"
CLOUDINARY_API_KEY="your_cloudinary_api_key"
CLOUDINARY_SECRET_KEY="your_cloudinary_secret_key"
CLOUDINARY_NAME="your_cloudinary_name"
JWT_SECRET="your_jwt_secret_key"
ADMIN_EMAIL="admin_email_address"
ADMIN_PASSWORD="admin_password"
STRIPE_SECRET_KEY="your_stripe_secret_key"
```
4. Start the development server:
* Back-End
```console
npm run server
```
* Front-End
```console
npm run dev
```
* Admin
```console
npm run dev
```
5. Access the app on `http://localhost:5173/` for **UI** and `http://localhost:5174/` for **Admin Panel**.
## Screenshots
### User Dashboard 👤
### Admin Dashboard 🔐
## Future-Enhancements
* Add product reviews and ratings.
* Implement user authentication with social logins.
* Add a _"Wishlist"_ feature for users to save products for future reference.
## Contribution
Contributions are welcome! Feel free to fork this repository, create a new branch, and submit a pull request with your updates or fixes.
## License
This project is licensed under the MIT License. See the LICENSE ➡️ [file](https://github.com/elyse502/ecommerce-app/blob/main/LICENSE) for more details📃.
## Author :black_nib:
- _[NIYIBIZI Elysée](https://linktr.ee/niyibizi_elysee)👨🏿💻 | [Github](https://github.com/elyse502) | [Linkedin](https://www.linkedin.com/in/niyibizi-elys%C3%A9e/) | [Twitter](https://twitter.com/Niyibizi_Elyse)._
[](https://www.linkedin.com/in/niyibizi-elys%C3%A9e/) [](https://twitter.com/Niyibizi_Elyse) [](https://github.com/elyse502)