Skip to content

A full-stack Flask application for searching, tracking, and organizing books using the Google Books API.

Notifications You must be signed in to change notification settings

PavanRa-crypto/BookLibraryApp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📚 Book Library App (API-Based)

This project is a full-stack Flask application built by M Pavan. It allows users to search, track, and organize books using live data from the Google Books API. The system requires no database or user authentication — all data is stored temporarily through Flask sessions.


🚀 Features

  • Book Search: Search by title, author, or ISBN through the Google Books API
  • Book Details: View descriptions, cover images, metadata, categories, and publishing details
  • My Library: Add or remove books, mark them as read/unread (session-based storage)
  • Sorting & Statistics: Filter by read/unread and view reading progress
  • Responsive UI: Clean, modern HTML/CSS interface suitable for mobile and desktop
  • No Database Needed: Lightweight and easy to deploy

🛠 Tech Stack

  • Frontend: HTML, CSS (Bootstrap), server-rendered templates
  • Backend: Python (Flask), session-based state management
  • External API: Google Books API
  • Data Storage: Flask session

📂 Project Structure

BookLibraryApp/
├─ app/
│  ├─ __init__.py
│  ├─ routes.py
│  ├─ api.py
│  ├─ utils.py
│  ├─ templates/
│  │  ├─ base.html
│  │  ├─ index.html
│  │  ├─ search.html
│  │  ├─ details.html
│  │  └─ library.html
│  └─ static/
│     └─ css/
│        └─ styles.css
├─ requirements.txt
├─ run.py
└─ README.md

🔑 API Key Configuration

The Google Books API can often be used without an API key. However, for higher reliability, you may generate a key from the Google Developer Console.

You may configure it by:

  • Editing API_KEY in app/routes.py, or
  • Setting an environment variable (recommended for deployment)

🖥️ How to Run

  1. Clone the repository
git clone <repo-url>
cd BookLibraryApp
  1. Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate   (macOS/Linux)
venv\Scripts\activate      (Windows)
  1. Install project dependencies
pip install -r requirements.txt
  1. Run the application
python run.py
  1. Open in browser

Visit: http://127.0.0.1:5000


🎨 Screenshots

Home Page

Home Page

Search Results

Search Results

Book Details

Book Details

My Library

My Library


📖 API Reference

a


✨ Credits

Developed by M Pavan. Built using Flask, Requests, and the Google Books API.


About

A full-stack Flask application for searching, tracking, and organizing books using the Google Books API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published