Skip to content

About

A book-recommendation platform

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

26 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ShelfScape

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.


Features

  • 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

Technologies Used

  • Frontend: React.js, Tailwind CSS
  • Backend: Node.js, Express.js
  • Recommendation System: Python, FastAPI

📸 Screenshots

🏠 Landing Page

Homepage

📖 Onboarding Page

Onboarding Pages Onboarding Pages

📚 Recommendations Section

Recommendations

👥 Dashboard

Dashboard

🔐 Login/Signup Page

Login/Signup

Getting Started

Prerequisites

  • Node.js (v14 or above)
  • npm or yarn

Installation

  1. Clone the repository:
    git clone https://github.com/Sambodhi-Roy/ShelfScape.git
    
  2. Navigate to the frontend directory:
    cd shelfscape/frontend
    
  3. Install dependencies:
    npm i
    
  4. Start the development server:
    npm run dev
    
  5. The app will be running at http://localhost:3000

Note: Backend setup instructions will be added soon.

Project Structure

  • /frontend – React.js frontend code
  • /backend – Node.js backend API (in development)
  • /ml – Machine learning recommendation system integration

Future Plans

  • 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

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve ShelfScape.

About

A book-recommendation platform

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages