/SwapReads

This repo is officially accepted for GSSOC'2k24. SwapReads.com is the ultimate online destination for book enthusiasts to connect, exchange favorite reads, and embark on literary adventures. Create your profile, list the books you're eager to swap, and join a vibrant community of passionate readers.

Primary LanguageHTML

SwapReads.com

Connect, Exchange, Explore – Where Book Enthusiasts Swap Books and Discover New Literary Adventures!

License: MIT

🌟 Stars 🍴 Forks 🐛 Issues 🔔 Open PRs 🔕 Close PRs
Stars Forks Issues Open Pull Requests Close Pull Requests
SwapReads.com is the solution to common challenges faced by book enthusiasts in today's digital age. We've identified key problems and developed a platform that addresses them efficiently and effectively.

The Problem:

  1. Limited Book Access:

    • Many readers struggle to find a variety of books locally.
  2. Book Expenses and Sustainability:

    • Buying new books is expensive, and the environmental impact of book production is a concern.
  3. Lack of Personalized Recommendations:

    • Generic book recommendations from algorithms lack a personal touch.
  4. Social Isolation in Reading:

    • Reading has become a solitary activity, with readers missing out on sharing thoughts and discoveries.
  5. Unused Book Collections:

    • Readers often have books that are read and then set aside, collecting dust.

How SwapReads.com Solves These Problems:

  1. Global Book Exchange:

    • SwapReads.com connects users globally, allowing them to exchange books regardless of location.
  2. Cost-Effective and Sustainable Reading:

    • By swapping books, users reduce expenses and contribute to a more sustainable reading culture.
  3. Personalized Recommendations and Community Trust:

    • Users share favorite reads, providing and receiving personalized recommendations from a trusted community.
  4. Social Connection and Book Discussions:

    • Features like private messaging and community forums foster a social environment for book discussions.
  5. Revitalizing Unused Book Collections:

    • SwapReads.com encourages users to share and exchange books that are sitting idle on their shelves.

💻 Tech Stacks

JavaScript HTML CSS Firebase

Open Innovation Challenge:

SwapReads.com actively participates in the Open Innovation Challenge by cultivating a global community of readers. Our platform champions open access to a wide range of books, promotes sustainable reading habits through book swapping, and harnesses user-generated content to offer personalized recommendations. With community-driven discussions and data-driven optimizations, SwapReads.com is committed to advancing the goals of inclusivity, sustainability, and collaborative innovation in the world of literature.

Join SwapReads.com today and embark on a literary journey like never before!

Getting started

  1. Clone the repo
 git clone https://github.com/anuragverma108/SwapReads
  1. Install npm packages
npm install
  1. Run index.html with any browser (example: chrome etc).

Contribution

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  • If you have any suggestions for the project, such as reporting a bug, improving the UI, or enhancing the README.md file, feel free to open an issue to discuss it or directly create a pull request with the necessary changes.
  • Please make sure to check your spelling and grammar.
  • Create individual pull requests for each suggestion to keep changes focused and manageable.

Your involvement helps to improve the project and make it better for everyone. Thank you for your contributions!

Creating Pull Request

  1. Fork the Project:

    • Click on the "Fork" button at the top right corner of the repository's page on GitHub to create your own copy of the project.
  2. Clone Your Forked Repository:

    • Clone the forked repository to your local machine using the following command:
     git clone https://github.com/anuragverma108/SwapReads
  3. Create a New Branch and Move to the Branch:

    • Create a new branch for your changes and move to that branch using the following commands:
    git checkout -b <branch-name>
  4. Add Your Changes:

    • After you have made your changes, check the status of the changed files using the following command:
    git status -s
    • Add all the files to the staging area using the following command:
    git add .

    or add specific files using:

    git add <file_name1> <file_name2>
  5. Commit Your Changes:

    • Commit your changes with a descriptive message using the following command:
    git commit -m "<EXPLAIN-YOUR_CHANGES>"
  6. Push Your Changes:

    • Push your changes to your forked repository on GitHub using the following command:
    git push origin <branch-name>
  7. Open a Pull Request:

    • Go to the GitHub page of your forked repository, and you should see an option to create a pull request. Click on it, provide a descriptive title and description for your pull request, and then submit it.

Our Contributors ❤️

Thank you for contributing to our repository

Contributors

Show some ❤️ by starring this awesome repository!