Skip to content

shauryadabral/BookScout

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š BookScout – Smart Book Recommendation Web App

BookScout is a swipe-based book recommendation web application inspired by Tinder-style interactions.
Users can like or dislike books, explore book details with real cover images, and view their liked books in a visually rich and magical interface.

This project focuses on building a complete frontend–backend system and is designed to be machine-learning ready for future upgrades.


πŸš€ Features

  • πŸ“– Swipe-based book browsing (Like / Dislike)
  • ✨ Animated book cards with flip & sparkle effects
  • πŸ–Ό Real book cover images using Google Books API
  • ❀️ Liked books list panel
  • πŸ“Š Backend summary (total likes & dislikes)
  • 🎨 Modern and magical UI
  • πŸ”Œ REST API-based frontend–backend communication
  • 🧠 ML-ready architecture for future enhancements

πŸ›  Tech Stack

Frontend

  • React.js
  • Vite
  • JavaScript (JSX)
  • CSS (Animations & Responsive Design)

Backend

  • Node.js
  • Express.js
  • JSON-based data storage

External API

  • Google Books API (for book cover images)

πŸ“‚ Project Structure

bookscout-simplified/
β”‚
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”‚   β”œβ”€β”€ App.jsx
β”‚   β”‚   β”‚   β”œβ”€β”€ BookCard.jsx
β”‚   β”‚   β”‚   └── SwipeCard.jsx
β”‚   β”‚   β”œβ”€β”€ data/
β”‚   β”‚   β”‚   └── books.json
β”‚   β”‚   β”œβ”€β”€ App.css
β”‚   β”‚   └── main.jsx
β”‚   └── package.json
β”‚
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ server.js
β”‚   β”œβ”€β”€ fetch_covers.js
β”‚   β”œβ”€β”€ choices.json
β”‚   └── package.json
β”‚
└── README.md

About

BookScout is a swipe-based book recommendation web application inspired by Tinder-style interactions. Users can **like or dislike books**, explore book details with real cover images, and view their liked books in a visually rich and magical interface.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors