ShelfScape is a book recommendation and community platform designed to help readers discover personalized book recommendations and connect with others through genre-based book clubs and chat rooms. Built with a focus on a responsive and engaging frontend experience, ShelfScape aims to combine a powerful recommendation system with a social platform for book lovers.
- Personalized book recommendations powered by a machine learning model
- Secure user authentication and account management
- Responsive and dynamic UI built with React.js and styled using Tailwind CSS
- Modular frontend architecture designed to support future features like:
- Genre-specific chat rooms (similar to Discord servers)
- Book clubs and discussion forums
- User reviews and ratings
- Frontend: React.js, Tailwind CSS
- Backend: Node.js, Express.js
- Recommendation System: Python, FastAPI
- Node.js (v14 or above)
- npm or yarn
- Clone the repository:
git clone https://github.com/Sambodhi-Roy/ShelfScape.git
- Navigate to the frontend directory:
cd shelfscape/frontend - Install dependencies:
npm i
- Start the development server:
npm run dev
- The app will be running at http://localhost:3000
Note: Backend setup instructions will be added soon.
- /frontend – React.js frontend code
- /backend – Node.js backend API (in development)
- /ml – Machine learning recommendation system integration
- Implement genre-based chat rooms for book discussions
- Add book clubs and community forums
- Enable user reviews, ratings, and recommendations sharing
- Enhance recommendation algorithm with user feedback
Contributions are welcome! Feel free to open issues or submit pull requests to improve ShelfScape.





