🛒 Ratna Supermarket

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.

✨ Project Overview

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.

🌐 Demo

🌐 Live Demo: Ratna Supermarket

🎯 Objective:

To create a user-friendly and responsive online shopping platform that allows customers to explore, add products to their cart, and place orders effortlessly.

🔥 Features

• 🛒 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.

🛠️ Tech Stack

• Frontend: React.js, Tailwind CSS
• Backend: Node.js, Express.js
• Database: MongoDB
• Hosting: Firebase

🚀 Getting Started

Follow these steps to set up and run the Ratna Supermarket project on your local machine:

Prerequisites

Ensure that the following software is installed on your system:

• Node.js (v14.x or higher)
• npm (Node package manager)
• React.js(React JS)

Installation

1. 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.

2. Clone the repository:
   Clone the forked repository to your local machine:

   git clone https://github.com/yourusername/Ratna-Supermarket.git

3. Navigate to the project directory:
   Change your directory to the cloned project folder:

   cd Ratna-Supermarket
   cd client

4. Install the dependencies:
   Run the following command to install all the necessary dependencies:

   npm install

5. Start the development server:
   Launch the project in development mode by running:

   npm run dev

6. Open the app:
   Open your browser and visit http://localhost:5173 to see the app in action.

📜 Contributing

We welcome contributions from the community! To contribute, please check out our CONTRIBUTING.md and CODE_OF_CONDUCT.md to understand the guidelines.

Quick Guide:

1. Fork and clone the repository.
2. Create a new branch for your feature/bug fix.
3. Make your changes and test them.
4. Submit a pull request for review.

For more details, refer to the CONTRIBUTING.md file.

🤝 Open Source Programs

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!

🌟 Mentors

Special thanks to our amazing mentors who are guiding this project! 🙌

• [To be announced] - Full Stack Developer

👀 Our Contributors

• 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.

--- ## ⭐Support - ⭐ Star our Repo