Skip to content

RS-Arafath/world-famous-book

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

110 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š Book Vibe

Where Every Page Sparks Joy

A modern, responsive book discovery web app β€” explore world-famous books, view detailed info, and track your personal reading journey.

Live Demo GitHub


πŸ–ΌοΈ Preview

home

- Home Page

Book Details

- Book Details

Reading and Wish List

- Book Activity

Reading stats

- Book Stats

User Login

- User LogIn


✨ Features

  • πŸ“– Book Collection β€” Browse a curated list of world-famous books across multiple genres
  • πŸ” Book Details Page β€” View full info: author, category, tags, rating, number of pages, publisher, and year
  • πŸ“Œ Read List β€” Save books you want to read using the browser's LocalStorage
  • βœ… Finished List β€” Keep track of books you've already completed
  • 🚫 Duplicate Prevention β€” Toast notifications alert you when a book is already in your list
  • πŸ“Š Reading Stats β€” Visual bar chart showing your reading progress by page count
  • πŸ”€ Multi-Page Routing β€” Smooth client-side navigation with React Router DOM
  • ❌ Custom 404 Page β€” Friendly "Not Found" page for invalid routes
  • πŸ“± Fully Responsive β€” Works seamlessly on desktop, tablet, and mobile

πŸ› οΈ Tech Stack

Category Technology
βš›οΈ UI Library React.js v18
⚑ Build Tool Vite
🎨 Styling Tailwind CSS
🧩 UI Components DaisyUI
πŸ” Routing React Router DOM v6
πŸ“Š Charts Recharts
πŸ”” Notifications React Toastify
πŸ’Ύ Data Persistence LocalStorage API
πŸš€ Deployment Vercel

πŸ“¦ Dependencies

{
  "dependencies": {
    "react": "^18.x",
    "react-dom": "^18.x",
    "react-router-dom": "^6.x",
    "recharts": "^2.x",
    "react-toastify": "^10.x"
  },
  "devDependencies": {
    "vite": "^5.x",
    "@vitejs/plugin-react": "^4.x",
    "tailwindcss": "^3.x",
    "daisyui": "^4.x",
    "postcss": "^8.x",
    "autoprefixer": "^10.x",
    "eslint": "^8.x"
  }
}

πŸ“ Project Structure

world-famous-book/
β”œβ”€β”€ public/
β”‚   └── json data/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ assets/               # Static images
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ Navbar/           # Navigation bar
β”‚   β”‚   β”œβ”€β”€ Banner/           # Hero/banner section
β”‚   β”‚   β”œβ”€β”€ BookCard/         # Individual book card
β”‚   β”‚   β”œβ”€β”€ BookDetails/      # Book detail modal/page
β”‚   β”‚   └── Footer/           # Footer component
β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ Home/             # Home page β€” book listing
β”‚   β”‚   β”œβ”€β”€ ListedBooks/      # Read list & finished list tabs
β”‚   β”‚   β”œβ”€β”€ PagesToRead/      # Reading stats with bar chart
β”‚   β”‚   └── NotFound/         # Custom 404 page
β”‚   β”œβ”€β”€ utils/
β”‚   β”‚   └── localStorage.js   # LocalStorage helper functions
β”‚   β”œβ”€β”€ App.jsx               # Root component & route config
β”‚   └── main.jsx              # Entry point
β”œβ”€β”€ index.html
β”œβ”€β”€ tailwind.config.js
β”œβ”€β”€ vite.config.js
└── package.json

πŸš€ Getting Started

Prerequisites

Installation

# 1. Clone the repository
git clone https://github.com/RS-Arafath/world-famous-book.git

# 2. Move into the project folder
cd world-famous-book

# 3. Install all dependencies
npm install

# 4. Start the dev server
npm run dev

Open your browser at http://localhost:5173

Build for Production

npm run build

🌐 Live Demo

πŸ‘‰ https://book-vibe-bd.vercel.app/


πŸ“Έ Pages Overview

Page Route Description
Home / Browse the full book collection
Book Details /book/:id View detailed info for a specific book
Listed Books /listed-books Your read & finished book lists
Pages to Read /pages-to-read Bar chart of your reading stats
404 Not Found * Custom error page for invalid routes

🀝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/your-feature
  3. Commit your changes: git commit -m "Add: your feature description"
  4. Push to the branch: git push origin feature/your-feature
  5. Open a Pull Request

πŸ‘¨β€πŸ’» Author

RS Arafath

GitHub


πŸ“„ License

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


Made with ❀️ by RS Arafath

About

Modern book tracking web app to explore books, manage read lists, and organize your reading experience with a clean UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages