https://github.com/sanketjaswal/book-surf
A personalized book recommendation app that enhances reading discovery with tailored suggestions.
https://github.com/sanketjaswal/book-surf
mongodb node react
Last synced: 3 months ago
JSON representation
A personalized book recommendation app that enhances reading discovery with tailored suggestions.
- Host: GitHub
- URL: https://github.com/sanketjaswal/book-surf
- Owner: sanketjaswal
- Created: 2025-02-20T20:22:14.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-02-21T07:50:19.000Z (3 months ago)
- Last Synced: 2025-02-21T08:22:40.406Z (3 months ago)
- Topics: mongodb, node, react
- Language: JavaScript
- Homepage: https://book-surf.onrender.com/
- Size: 3.38 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📚 Book Surf
### Overview
The Personalized Book Recommendation Web Application is a full-stack web application that allows users to get book recommendations based on their preferences, including genres, authors, and ratings. The application consists of a React frontend and a Node.js/Express backend with MongoDB.
## Application Link
[https://book-surf.onrender.com/](https://book-surf.onrender.com/)
## Features
- **Recommendations**: Users receive book suggestions based on genres, authors.
- **RESTful API**: Endpoints for handling book data and recommendations.
- **MongoDB Database**: Stores book details and optionally user preferences.
- **Genre DropDown**: Search books based on genre.
- **Author Search**: Search Books based on Authors.
- **Responsive Design**: The layout adapts seamlessly to different screen sizes.
- **Animations**: Soothing Animations for Application using Javascript.
## Setup Instructions
### 1. Clone the repository
```shell
git clone https://github.com/sanketjaswal/book_recommeder.git
cd Book-recommendation
```
### 2. Install dependencies
```shell
cd backend
npm install
cd frontend
npm install
```
### 3. Set Up Environment Variables
```shell
MONGO_URI=your_mongo_connection_string
PORT=5000
```
### 4. Start the application
```shell
cd backend
npm run dev
cd frontend
npm start
```
This will run the app in development mode in http://localhost:5000.
## Dependencies
Below is a list of dependencies used in the project:
- **Frontend** : React.js
- **Backend** : Node.js, Express.js, MongoDB
- **Database** : MongoDB
- **Hosting** : Render
## Code Structure
```shell
book_recommender/
│-- backend/
│ ├── src/
│ │ ├── models/
│ │ │
│ │ ├── controllers/
│ │ │
│ │ ├── routes/
│ │ │
│ │ ├── server.js
│
│-- frontend/
│ ├── src/
│ │ ├── components/
│ │ │
│ │ ├── pages/
│ │ │ ├── Home.js
│ │ ├── App.js
│
│-- README.md
```
# Conclusion
A personalized book recommendation app that enhances reading discovery with tailored suggestions.
Happy Reading !!