Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shashank02051997/quickmart-web-app
🌟 QuickMart is your one-stop e-commerce app for everything you need, from fresh milk 🥛 and groceries 🛒 to stylish dresses 👗, snacks 🍪, and the latest electronics 💻. Built using Flutter 📱 and backed by a powerful Node.js API 🚀 with MySQL 🗄️, QuickMart offers a seamless shopping experience from product search 🔎 to order tracking 📊.
https://github.com/shashank02051997/quickmart-web-app
admin-dashboard admin-panel api docker ecommerce mobile mysql nodejs
Last synced: 20 days ago
JSON representation
🌟 QuickMart is your one-stop e-commerce app for everything you need, from fresh milk 🥛 and groceries 🛒 to stylish dresses 👗, snacks 🍪, and the latest electronics 💻. Built using Flutter 📱 and backed by a powerful Node.js API 🚀 with MySQL 🗄️, QuickMart offers a seamless shopping experience from product search 🔎 to order tracking 📊.
- Host: GitHub
- URL: https://github.com/shashank02051997/quickmart-web-app
- Owner: Shashank02051997
- License: mit
- Created: 2024-09-08T15:20:44.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2024-09-09T22:17:42.000Z (5 months ago)
- Last Synced: 2024-11-21T13:52:44.711Z (3 months ago)
- Topics: admin-dashboard, admin-panel, api, docker, ecommerce, mobile, mysql, nodejs
- Language: JavaScript
- Homepage:
- Size: 3.61 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Quick Mart
## Description
🌟 QuickMart is your one-stop e-commerce app for everything you need, from fresh milk 🥛 and groceries 🛒 to stylish dresses 👗, snacks 🍪, and the latest electronics 💻. Built using Flutter 📱 and backed by a powerful Node.js API 🚀 with MySQL 🗄️, QuickMart offers a seamless shopping experience from product search 🔎 to order tracking 📊, complete with an intuitive admin dashboard 🛡️ for streamlined management.
## Table of Contents
- [Installation](#installation)
- [Features](#features)
- [Screenshots](#screenshots)
- [Technologies Used](#technologies-used)
- [Contributing](#contributing)
- [Links](#links)
- [License](#license)
## Installation
To install Quick Mart, follow these steps:
1. Clone the repository.
2. Install the dependencies in both the client and server directories by running `npm i` at the root directory.
3. Create a .env file in the server directory and add the following environment variables:
```
PORT
DB_PORT
DB_HOST
DB_NAME
DB_USERNAME
DB_PASSWORD
JWT_SECRET
```
4. Run `npm run dev` at the root directory to start the development server and launch the app in your browser.
5. Navigate to http://localhost:6868/ to view the project.
## Features
### 🔐 User Authentication:
- **Sign In and Sign Up**: Effortlessly create accounts or log in to start your shopping journey.
### 📱 OTP Verification:
- **Secure Verification**: Ensure user authenticity through OTP verification, adding an extra layer of security.
### 🛍️ Product Categories:
- **Diverse Product Range**: Explore a wide variety of product categories, including groceries, fresh milk, electronics, fashion, and more.
### 🔎 Product Search:
- **Find What You Need**: Quickly search for products using the powerful in-app search feature.
### 🛒 Cart Management:
- **Manage Your Cart**: Add, remove, or modify items in your cart for a smooth shopping experience.
### 🚀 Fast Deliveries:
- **Quick and Efficient**: Experience rapid deliveries with real-time tracking, ensuring your orders arrive on time.
### 📊 Order Management:
- **Track Orders Easily**: Stay updated with detailed order statuses, from placement to delivery.
### 👤 User Profile:
- **Manage Your Profile**: Update your personal information and manage your delivery addresses for a hassle-free checkout.
### 🛡️ Admin Dashboard:
- **Streamlined Management**: Intuitive admin dashboard for managing products, orders, and customer data efficiently.
## Screenshots
## Technologies Used
Quick Mart is built using a variety of technologies including:
- [Node.js](https://nodejs.org/en)
- [Express](https://expressjs.com/)
- [JWT](https://jwt.io/)
- [MySQL](https://www.mysql.com/)
## Docker Setup
To set up and run Motor Admin using Docker, follow these steps:
1. **Pull the Docker image:**
```bash
sudo docker pull motoradmin/motoradmin:latest
```
2. **Run the Docker container:**
```bash
sudo docker run -d \
--name motoradmin \
-p 3000:3000 \
-v ~/motoradmin/data:/app/storage \
-e SECRET_KEY_BASE=$(openssl rand -hex 64) \
motoradmin/motoradmin:latest
```
This command will:
- Run the Motor Admin container in detached mode (`-d`).
- Name the container `motoradmin`.
- Map port `3000` on your host to port `3000` in the container.
- Mount a local directory (`~/motoradmin/data`) to the container’s storage directory.
- Set a random `SECRET_KEY_BASE` for added security.
3. **Access Motor Admin:**
Open your web browser and navigate to [http://your_droplet_ip:3000](http://your_droplet_ip:3000).
## Contributing
Please fork this repository and contribute back using
[pull requests](https://github.com/Shashank02051997/QuickMart-Web-App/pulls).
Any contributions, large or small, major features, or bug fixes, are welcomed and appreciated
but will be thoroughly reviewed.
### Contact - Let's become a friend
- [Twitter](https://twitter.com/shashank020597)
- [Github](https://github.com/Shashank02051997)
- [Linkedin](https://www.linkedin.com/in/shashank-singhal-a87729b5/)
- [Facebook](https://www.facebook.com/shashanksinghal02)
### Like our Facebook page
- [Android UI's Bucket](https://www.facebook.com/androiduisbucket)
## Donation
If this project helps you reduce time to develop, you can give me a cup of coffee :)
## 💬 Discuss
Have any questions, or doubts or want to present your opinions or views? You're always welcome. You can [start discussions](https://github.com/Shashank02051997/QuickMart-Web-App/discussions).
## Links
- [Link to Flutter GitHub repository](https://github.com/Shashank02051997/QuickMart-Flutter)
## License
This project is licensed under the MIT License.