<div align="center">

📚 Online Book Sales 📚🖌️

<img src="https://readme-typing-svg.herokuapp.com?color=45ffaa&center=true&vCenter=true&size=40&width=900&height=80&lines=Welcome+to+Online+Book+Sales!"/> </div> <div align = "center"> <br> <table align="center"> <thead align="center"> <tr border: 1px;> <td><b>🌟 Stars</b></td> <td><b>🍴 Forks</b></td> <td><b>🐛 Issues</b></td> <td><b>🔔 Open PRs</b></td> <td><b>🔕 Close PRs</b></td> <td><b>🛠️ Languages</b></td> <td><b>👥 Contributors</b></td> </tr> </thead> <tbody> <tr> <td><img alt="Stars" src="https://img.shields.io/github/stars/Trisha-tech/OnlineBookSales?style=flat&logo=github"/></td> <td><img alt="Forks" src="https://img.shields.io/github/forks/Trisha-tech/OnlineBookSales?style=flat&logo=github"/></td> <td><img alt="Issues" src="https://img.shields.io/github/issues/Trisha-tech/OnlineBookSales?style=flat&logo=github"/></td> <td><img alt="Open Pull Requests" src="https://img.shields.io/github/issues-pr/Trisha-tech/OnlineBookSales?style=flat&logo=github"/></td> <td><img alt="Close Pull Requests" src="https://img.shields.io/github/issues-pr-closed/Trisha-tech/OnlineBookSales?style=flat&color=critical&logo=github"/></td> <td><img alt="GitHub language count" src="https://img.shields.io/github/languages/count/Trisha-tech/OnlineBookSales?style=flat&color=green&logo=github"></td> <td><img alt="GitHub Contributors count" src="https://img.shields.io/github/contributors/Trisha-tech/OnlineBookSales?style=flat&color=blue&logo=github"/></td> </tr> </tbody> </table> </div> <!--Line--> <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="900">

Welcome to Online Book Sales, an e-commerce platform where you can browse, purchase, and enjoy a wide range of books from our extensive catalog! Our system is built with a 3-tier architecture, featuring a MongoDB database backend, Node.js & Express.js middleware, and a sleek React frontend.

📑 Table of Contents

• Features 🚀
• Live Project Links 🌐
• Tech Stack 🛠️
• Code of Conduct 🌟
• How to Contribute 🤝
• How to Run Locally 💻
• Using GitHub Desktop 🖥️
• In-Depth Project Analysis 🔍
• Our Contributors 💖
• Contact Information 📧

---

Features

• User Registration & Login: Secure account creation with user authentication.
• Browse Books: Explore our rich catalog with detailed book info.
• Shopping Cart: Easily add, update, or remove items.
• Order History: View your past purchases at any time.

---

Live Project Links

• Frontend: Book4U 🖱️
• Backend: API Server 🌍

<!--line--> <img src="https://www.animatedimages.org/data/media/562/animated-line-image-0184.gif" width="1920" />

This project is now OFFICIALLY accepted for

<div align="center"> <img src="https://github.com/amiya-cyber/banner/blob/main/329829127-e79eb6de-81b1-4ffb-b6ed-f018bb977e88.png" alt="GSSoC 2024 Extd" width="60%"> </div> <div align="center"> <img src="https://github.com/amiya-cyber/banner/blob/main/hacktober.png" alt="Hacktober fest 2024" width="60%"> </div> <!--line--> <img src="https://www.animatedimages.org/data/media/562/animated-line-image-0184.gif" width="1920" />

Tech Stack

| Frontend | Backend | Database | | :------: | :-----: | :------: | | | | | | | | | | | | |

---

Code of Conduct

We encourage everyone to be respectful and inclusive. Please take a moment to review our Code of Conduct to help foster a positive environment. 💬

---

How to Contribute

We welcome all contributions! 🎉 If you'd like to add new features or fix bugs, check out the Contributing Guidelines to get started. Fork the repo, clone it, make your changes, and submit a pull request.

Here’s how to fork the project:

1. Navigate to the Repository:

   • Head to the Online Book Sales repository.

2. Click the Fork Button:

   • Click on the “Fork” button in the upper-right corner.

3. Create Your Copy:

   • Select your GitHub account to fork the repository.

---

How to Run the Webpage on Your Local System

Follow these steps to run the project on your local machine:

1. Clone the repository:

   git clone https://github.com/Trisha-tech/OnlineBookSales.git
   cd OnlineBookSales
   

2. Write the command.

   npm install
   

3. For Frontend Go to 'client' directory write command

   npm install
   

4. Write the command.

   yarn start / npm start
   

That's it! You’re ready to explore the application locally. 🚀

---

Troubleshooting

Common Installation Issues

• Error: npm install fails:
  • Ensure that Node.js and npm are correctly installed on your machine. You can check this by running node -v and npm -v in your terminal.
  • If you encounter permission issues, try using sudo npm install (for macOS/Linux) or running the command prompt as an administrator (for Windows).

Problems with Starting the Server

• Error: Cannot find module 'express':
  • This error usually indicates that the required packages haven't been installed. Make sure to run npm install in both the root and client directories.
• Server crashes on startup:
  • Check the console logs for any errors that may provide hints about what went wrong. Common issues could be related to incorrect environment variables or database connection strings.

Issues Related to Dependencies

• Version conflicts:
  • Ensure that all dependencies in your package.json are compatible. If you see warnings or errors during installation, consider using npm audit fix to resolve vulnerabilities.

FAQs

• Q: How do I reset my local database?

  • A: You can drop the existing database and run your migrations or seed scripts again. Make sure to back up any important data before doing this.

• Q: How can I contact support?

  • A: If you have further issues or questions, please open an issue in this repository, and we'll be happy to help!

Additional Suggestions

• Clarity: Make sure the instructions are as clear as possible. For example, specify where to run commands (in which directory).
• Links: If you refer to any external resources (like Node.js downloads), adding hyperlinks could be beneficial.

Using GitHub Desktop

Alternatively, you can use GitHub Desktop to manage the repository:

1. Download GitHub Desktop from here.
2. Clone the Repository by signing in to your GitHub account, selecting the repository, and clicking "Clone".
3. Make Changes: Edit code locally using your favorite editor.
4. Commit & Push: Commit your changes and push them to GitHub via the GitHub Desktop interface.

---

In-Depth Project Analysis

For a detailed overview of how the project works, please read the Project Details documentation. This will give you a deep dive into the architecture and design decisions. 🧠

---

Our Contributors

<h3 align="center">A big THANK YOU to all our contributors! 🙌</h3> <div align="center"> <img src="https://contrib.rocks/image?repo=Trisha-tech/OnlineBookSales" alt="Contributors"> </div>

---

Contact Information

If you have any questions or feedback, feel free to reach out via GitHub. You can also join our discussion forum.

We look forward to hearing from you! ✨

💙 Thank You !!! 💙