Skip to content

ngush67/book-recommendation-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

25 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Book Recommendation App

A full-stack web application that allows users to browse, add, and manage book recommendations. The app features a React frontend, a Node.js/Express backend, and MongoDB for database management.

🌟 Features

  • View a list of recommended books
  • Add new books with details like title, author, genre, and rating
  • Connects to a MongoDB cloud database for persistent storage
  • Responsive and clean UI built with Material UI (MUI)

πŸ”§ Project Structure

book-recommendation-app/
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ models/
β”‚   β”‚   └── Book.js
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   └── bookRoutes.js
β”‚   └── server.js
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”‚   β”œβ”€β”€ AddBook.js
β”‚   β”‚   β”‚   └── BookList.js
β”‚   β”‚   β”œβ”€β”€ services/
β”‚   β”‚   β”‚   └── bookService.js
β”‚   β”‚   β”œβ”€β”€ App.js
β”‚   β”‚   └── index.js
β”œβ”€β”€ package.json
β”œβ”€β”€ README.md
└── .gitignore

πŸ“Š Tech Stack

  • Frontend: React, Axios, Material UI
  • Backend: Node.js, Express, Mongoose
  • Database: MongoDB (Cloud)
  • Tools: Nodemon, Dotenv

πŸ› οΈ Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/book-recommendation-app.git
cd book-recommendation-app

2. Backend Setup

cd backend
npm install
  • Create a .env file in the backend directory:
MONGO_URI=your_mongodb_cloud_uri
  • Start the backend server:
npm run dev

3. Frontend Setup

cd ../frontend
npm install
npm start

4. Access the App

  • Frontend: http://localhost:3000
  • Backend API: http://localhost:5000/api/books

πŸ“Š API Endpoints

  • GET /api/books - Fetch all books
  • POST /api/books - Add a new book

🌟 Future Enhancements

  • Implement user authentication (Sign up/Login)
  • Add search and filter functionality
  • Enable book rating and reviews
  • Improve UI/UX with more advanced design

πŸ‘₯ Contributors

πŸ›‘οΈ License

This project is open-source and available under the MIT License.

About

A full-stack web application that allows users to browse, add, and manage book recommendations.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published