Welcome to Ratna Supermarket – an online shopping platform that delivers a complete and seamless e-commerce experience. From product browsing to order management, this project simulates a fully functional online store with an intuitive interface.
Ratna Supermarket is designed to provide users with a real-world shopping experience. It includes essential features such as product listings, cart management, user authentication, and order processing. Developed as part of a college project, it showcases a fully-fledged e-commerce platform using modern web development tools.
🌐 Live Demo: Ratna Supermarket
To create a user-friendly and responsive online shopping platform that allows customers to explore, add products to their cart, and place orders effortlessly.
- 🛒 Product Management: Users can browse, search, and filter products by categories.
- 🛍️ Cart System: Add or remove products, adjust quantities, and view the total price in the cart.
- 🔑 User Authentication: Secure login, sign-up, and logout functionalities.
- 💸 Order Management: Place and manage orders, track purchase history.
- 👤 Admin Dashboard: Admin can manage products, users, and orders (admin-specific features).
- 📱 Responsive Design: Optimized for mobile, tablet, and desktop devices.
- Frontend: React.js, Tailwind CSS
- Backend: Node.js, Express.js
- Database: MongoDB
- Hosting: Firebase
Follow these steps to set up and run the Ratna Supermarket project on your local machine:
Ensure that the following software is installed on your system:
-
Fork the repository:
Go to the Ratna Supermarket GitHub repository, click the "Fork" button in the top-right corner to create your own copy of the repository. -
Clone the repository:
Clone the forked repository to your local machine:git clone https://github.com/yourusername/Ratna-Supermarket.git
-
Navigate to the project directory:
Change your directory to the cloned project folder:cd Ratna-Supermarket cd client
-
Install the dependencies:
Run the following command to install all the necessary dependencies:npm install
-
Start the development server:
Launch the project in development mode by running:npm run dev
-
Open the app:
Open your browser and visithttp://localhost:5173to see the app in action.
We welcome contributions from the community! To contribute, please check out our CONTRIBUTING.md and CODE_OF_CONDUCT.md to understand the guidelines.
- Fork and clone the repository.
- Create a new branch for your feature/bug fix.
- Make your changes and test them.
- Submit a pull request for review.
For more details, refer to the CONTRIBUTING.md file.
This project is part of GirlScript Summer of Code 2024 (GSSoC) Extended, an initiative to help aspiring developers get involved in the open-source community.
This project is also part of Hacktoberfest 2024. We encourage participants to contribute and improve the project during this event. Let’s make open source accessible and fun for everyone!
Special thanks to our amazing mentors who are guiding this project! 🙌
- [To be announced] - Full Stack Developer
- We extend our heartfelt gratitude for your invaluable contribution to our project! Your efforts play a pivotal role in elevating Ratna-Supermarket to greater heights.
- Make sure you show some love by giving ⭐ to our repository.