About - Tavi's Book Library

🔐 Authentication & Security

Secure your book collection with Firebase Authentication. Only authenticated users can add, edit, or delete books from the library.

Email & Password Authentication: Create an account or log in to manage your collection
Secure Data Storage: Your books are stored securely in Firebase Firestore
User Sessions: Stay logged in across sessions for convenience
Admin Controls: Full CRUD operations for authenticated users

➕ Adding Books to Your Library

Multiple convenient ways to add books to your collection, from manual entry to advanced scanning technologies.

📝 Manual Entry

Enter book title and author name directly
Smart autocomplete suggestions powered by Google Books and Open Library APIs
Real-time search as you type with 300ms debouncing
Title field shows books by selected author when focused
Auto-fills author name when selecting a book from suggestions
Keyboard navigation support (arrow keys, Enter, Escape)
Duplicate detection prevents adding the same book twice
Visual highlighting with animation for newly added books (3-second duration)
Auto-scroll to newly added books in the table

📱 ISBN Scanning - Three Methods

📷 Photo Capture

Use your device camera to take a photo of the ISBN barcode
Advanced interactive image cropping tool to focus on the barcode area
Drag-and-drop crop handles with edge and corner resizing
OCR (Optical Character Recognition) powered by Tesseract.js
Automatically extracts ISBN from the photo using text recognition
Edit detected ISBN if recognition needs correction
Supports both ISBN-10 and ISBN-13 format detection

📊 Real-time Barcode Scanning

Live barcode scanning using device camera with Quagga2 library
Instant ISBN detection with visual feedback
Supports multiple barcode formats: EAN-13, EAN-8, UPC-A, UPC-E, and Codabar
Fast and accurate scanning technology with real-time processing
Automatic camera stream management

✏️ Manual ISBN Input

Type or paste ISBN directly
Accepts ISBN with or without hyphens
Perfect for when scanning isn't available

📚 Automatic Book Information Retrieval

Fetches book details from Google Books API using ISBN
Automatically populates title and author information
Fallback to Open Library API if Google Books doesn't have results
Automatic ISBN-13 to ISBN-10 conversion for additional lookup attempts
Validates ISBN format (10 or 13 digits without hyphens)
8-second timeout per API request to prevent hanging

🔍 Browsing & Searching

Powerful tools to organize and find books in your collection, whether you have 10 books or 10,000.

Real-time Search: Instantly filter books by title or author as you type
Smart Pagination: Navigate through large collections with ease (10 books per page)
Dynamic Page Numbers: Shows up to 5 page numbers at a time with ellipsis for large collections
Sortable Columns: Click on column headers to sort by title or author (ascending/descending)
Visual Indicators: Arrow indicators (▲▼) show current sort direction
Page Navigation: Jump to first, last, previous, or next page with dedicated buttons
Results Counter: See exactly how many books match your search and current page range
Automatic Page Reset: Returns to page 1 when sorting or starting a new search
Public Access: Browse and search the library even without logging in

✏️ Managing Your Collection

Full control over your book library with easy-to-use editing and management tools.

Edit Books: Update title or author information with dedicated edit form
Delete Books: Remove books from your collection with confirmation prompts
Action Buttons: Quick access to edit (✏️) and delete (🗑️) icons next to each book
Cancel Edits: Easily revert changes before saving without losing data
Real-time Updates: Firebase Firestore provides instant synchronization across all views
Permission Management: Only authenticated users can modify the collection

📱 User Experience Features

Responsive Design: Works perfectly on desktop, tablet, and mobile devices
Mobile-Optimized: Touch-friendly interface with proper button sizing (44px minimum)
Fixed Mobile Headers: Authentication status stays visible while scrolling on mobile
Camera Integration: Native camera access with automatic facingMode: 'environment' for rear cameras
Modal Windows: Bottom-sheet style modals on mobile for better ergonomics
Visual Feedback: Status messages, loading indicators, and real-time progress updates
Error Handling: Comprehensive error messages for camera permission, network issues, and API failures
Smooth Animations: 3-second highlight pulse animation for newly added books
Intuitive Navigation: Tab-based interface for switching between Photo, Barcode, and Manual input
Performance: Debounced search and autocomplete to reduce API calls
Security Checks: HTTPS requirement validation for camera access

🛠️ Technology Stack

Built with modern web technologies for reliability, performance, and security.

Firebase Authentication Secure user management

Firebase Firestore Real-time NoSQL database

Tesseract.js v4 OCR for photo ISBN detection

Quagga2 v1.10.2 Real-time barcode scanning

Google Books API Primary book data source

Open Library API Fallback & autocomplete data

Vanilla JavaScript (ES6+) Modular, no frameworks

Responsive CSS3 Mobile-first design

💡 How It Works

For Visitors: Browse and search the book collection freely. Use the search bar to find specific titles or authors, and click column headers to sort the library.

For Admins: Log in to unlock the full power of the application. Add books manually or scan ISBNs using your camera. Edit or remove books as your collection grows. All changes sync in real-time to the cloud.

📚 About Tavi's Book Library