Skip to content

Latest commit

 

History

History
106 lines (77 loc) · 3.76 KB

README.md

File metadata and controls

106 lines (77 loc) · 3.76 KB

SwapReads.com

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

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. Site preview

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:

  • Front End: HTML, CSS, and JavaScript
  • Backend: Firebase
  • Authentication: Firebase

Open Innovation Challenge:

SwapReads.com contributes to the Open Innovation Challenge track by fostering a global community of readers. The platform promotes open access to diverse books, encourages sustainable reading practices through book swapping, and leverages user-generated content for personalized recommendations. With features like community-driven discussions and data-driven optimizations, SwapReads.com aligns with the challenge's goals of inclusivity, sustainability, and collaborative innovation in the realm 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).

Contributing

Contributions are what makes 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 projects, like reporting a bug, improving UI, or improving 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 you check your spelling and grammar.
  • Create individual PR for each suggestion.

Creating Pull Request

  1. Fork the Project
  2. Clone your forked repository
  3. Now go ahead and create a new branch and move to the branch
git checkout -b <branch-name>
  1. After you have added your changes, follow the following command chain Check the changed files
git status -s
  1. Add all the files to the staging area
git add .

or

git add <file_name1> <file_name2>
  1. Commit your changes
git commit -m "<EXPLAIN-YOUR_CHANGES>"
  1. Push your changes
git push origin <branch-name>
  1. Open a Pull Request