Skip to content

Sambodhi-Roy/ShelfScape

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 

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

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors