Skip to content

πŸ“š Book Explorer – A sleek React + Tailwind web app for browsing and discovering books using the Open Library API. Search by title, author, or keyword, and view rich book details in a modern UI.

Notifications You must be signed in to change notification settings

martian56/book-explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š Book Explorer

Book Explorer is a modern, responsive React web app that allows users to search for and explore books using the Open Library API. With a sleek UI built using Tailwind CSS, users can search books by title, author, or keyword and view detailed information about each book.

✨ Features

  • πŸ” Search functionality for books by title, author, or keyword
  • πŸ–ΌοΈ Beautiful book cards with cover images and author details
  • πŸ“– Detailed book pages with descriptions, subjects, authors, and links
  • πŸ’… Clean, responsive UI with Tailwind CSS
  • ⚑ Fast client-side routing using react-router-dom
  • πŸ” Initial fetch of "bestsellers" on homepage load
  • πŸŒ™ Dark-themed layout with subtle gradients and animations
  • 🦾 Loading states, graceful error handling, and fallback UI

πŸ› οΈ Tech Stack

  • Vite – Fast build tool for modern web apps
  • React – Frontend UI library
  • Tailwind CSS – Utility-first CSS framework
  • React Router DOM – Client-side routing
  • Open Library API – Free public API for books data

πŸš€ Getting Started

1. Clone the repo

git clone https://github.com/martian58/book-explorer.git
cd book-explorer

2. Install dependencies

npm install

3. Start the development server

npm run dev

Open http://localhost:5173 to view the app in your browser.


πŸ“‚ Project Structure

book-explorer/
β”œβ”€β”€ public/               # Static files (e.g. favicon)
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ Book.jsx      # Book card component
β”‚   β”‚   └── Footer.jsx    # Sticky footer
β”‚   β”œβ”€β”€ pages/
β”‚   β”‚   β”œβ”€β”€ Home.jsx      # Homepage with search and results
β”‚   β”‚   └── BookDetail.jsx# Book detail page
β”‚   β”œβ”€β”€ App.jsx           # Routing config
β”‚   └── main.jsx          # React root
β”œβ”€β”€ index.html
└── vite.config.js

πŸ–ΌοΈ Screenshots

πŸ”Ž Home Page

Hero section with gradient title and search bar.
Dynamically updated book grid. Fully responsive with smooth animations.

Home Page Screenshot


πŸ“˜ Book Detail

Displays cover image, title, description, subjects, and authors.
Authors fetched dynamically with clean badges and external links.

Book Detail Screenshot


πŸ”— API Used

  • Open Library Search API: https://openlibrary.org/search.json?q=...

  • Open Library Works API: https://openlibrary.org/works/{id}.json

  • Book Cover Images: https://covers.openlibrary.org/b/id/{cover_id}-L.jpg


πŸ’‘ Future Ideas

  • πŸ“Œ Add user bookmarks or reading lists
  • 🌐 Filter by genre or language
  • πŸ”– Pagination and infinite scroll
  • πŸ—£οΈ Add user reviews (via external API)

πŸ“„ License

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


πŸ™Œ Acknowledgements

About

πŸ“š Book Explorer – A sleek React + Tailwind web app for browsing and discovering books using the Open Library API. Search by title, author, or keyword, and view rich book details in a modern UI.

Topics

Resources

Stars

Watchers

Forks