Merge branch 'main' into 202

Author: chilkotiKartik

.env.example

@@ -100,4 +100,3 @@ PURCHASE_LINKS_MAX_RETRIES=3
 PURCHASE_LINKS_RETRY_DELAY=1.0
 PURCHASE_LINKS_MAX_CONCURRENT=4
 PURCHASE_LINKS_LOG_LEVEL=INFO
->>>>>>> main

.github/CODEOWNERS

@@ -1,4 +1,5 @@
 GITHUB_ISSUES.md
+.github/CODEOWNERS.md
 
 # Mood analysis cache files
 mood_analysis/mood_cache.json

.gitignore

@@ -6,6 +6,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>Page Not Found | BiblioDrift</title>
   <link rel="stylesheet" href="style.css" />
+  <link rel="stylesheet" href="style-responsive.css" />
 
   <!-- Fonts -->
   <link rel="preconnect" href="https://fonts.googleapis.com" />

404.html

@@ -61,10 +61,67 @@ Enhancement suggestions are tracked as GitHub issues. Only recommendations that
 
 ## 📥 Pull Request Process
 
-1.  Ensure any install or build dependencies are removed before the end of the layer when doing a build.
-2.  Update the `README.md` with details of changes to the interface, this includes new environment variables, exposed ports, useful file locations and container parameters.
-3.  Increase the version numbers in any example files and the README.md to the new version that this Pull Request would represent.
-4.  You may merge the Pull Request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
+To keep the project organized and maintain high-quality contributions, please follow the process below before submitting a pull request.
+
+### 1️⃣ Prepare Your Changes
+
+Before creating a pull request:
+
+* Ensure your code runs correctly and does not introduce errors.
+* Remove any unnecessary files such as temporary files, logs, or build artifacts.
+* Make sure dependencies are clean and only required packages remain.
+
+### 2️⃣ Keep the Project Clean
+
+* Avoid committing compiled files, node modules, or environment-specific files.
+* Ensure your code follows the project's existing structure and naming conventions.
+* Test the application locally to verify that everything works as expected.
+
+### 3️⃣ Update Documentation
+
+If your changes affect the system, make sure to update the documentation:
+
+* Update the **README.md** with clear explanations of the changes.
+* Document any new environment variables, configuration steps, or setup instructions.
+* Mention any new folders, APIs, or features introduced in your contribution.
+
+### 4️⃣ Version Updates
+
+If your contribution introduces noticeable improvements:
+
+* Update version numbers where applicable.
+* Mention the version update in the README or relevant configuration files.
+* Provide a short summary of what changed in that version.
+
+### 5️⃣ Write a Clear Pull Request
+
+When submitting your PR:
+
+* Use a clear and meaningful title.
+* Provide a detailed description explaining what your changes do.
+* Reference related issues if applicable.
+* Add screenshots or examples when UI changes are involved.
+
+### 6️⃣ Code Review Process
+
+* Your pull request will be reviewed by project maintainers.
+* Be open to feedback and make necessary improvements if requested.
+* Ensure that your contribution aligns with the project's goals and coding standards.
+
+### 7️⃣ Approval and Merge
+
+* Once your PR receives approval from at least **two maintainers or reviewers**, it can be merged.
+* If you do not have merge permissions, a maintainer will merge it for you after approval.
+* Make sure all checks and discussions are resolved before requesting a merge.
+
+### 8️⃣ After Merge
+
+After your pull request is merged:
+
+* Pull the latest changes from the main branch.
+* Continue contributing by working on new issues or improvements.
+* Help review other contributions if possible.
+
 
 ## 🎨 Code Style
 

CONTRIBUTING.md

@@ -6,6 +6,23 @@ Welcome to BiblioDrift! This comprehensive tutorial will guide you through disco
 
 BiblioDrift is more than just a book finder—it's a sanctuary for readers who discover books through emotions and vibes rather than rigid categories. Imagine wandering through a warm, quiet bookstore where books practically whisper their stories to you.
 
+
+## Why BiblioDrift is Different
+
+Unlike traditional platforms that focus heavily on categories and algorithms, BiblioDrift emphasizes:
+
+🎨 Visual-first discovery – Explore beautiful book covers and curated collections
+
+💫 Emotion-based browsing – Find books by how you feel, not just by genre
+
+📖 Curated recommendations – Thoughtfully selected reads instead of endless scrolling
+
+🧘 Calm, cozy experience – A distraction-free space designed for mindful browsing
+
+It’s not about finding the most popular book.
+It’s about finding the right book for you.
+
+
 ### Core Philosophy
 - **"Zero UI Noise"**: Clean, distraction-free browsing experience
 - **Tactile Interaction**: 3D books you can pull from shelves and flip over

TUTORIAL.md

@@ -128,11 +128,28 @@ class BookRenderer {
         const scene = document.createElement('div');
         scene.className = 'book-scene';
 
+        // Badge Logic
+        let badgesHTML = '';
+        const isNew = bookData.date_added && (new Date() - new Date(bookData.date_added)) < (7 * 24 * 60 * 60 * 1000);
+        const isPopular = volumeInfo.ratingsCount && volumeInfo.ratingsCount > 1000;
+        
+        if (isNew || isPopular || categories.length > 0) {
+            badgesHTML += '<div class="book-badge-container">';
+            if (isNew) badgesHTML += '<span class="book-badge badge-new">New</span>';
+            if (isPopular) badgesHTML += '<span class="book-badge badge-popular">Popular</span>';
+            if (categories.length > 0) {
+                const mainGenre = categories[0].split(' / ')[0]; // Take first category part
+                badgesHTML += `<span class="book-badge badge-genre" title="${mainGenre}">${mainGenre}</span>`;
+            }
+            badgesHTML += '</div>';
+        }
+
         // Load flip sound
         const flipSound = new Audio('assets/sounds/page-flip.mp3');
         flipSound.volume = 0.5;
 
         scene.innerHTML = `
+            ${badgesHTML}
             <div class="book" data-id="${id}">
                 <div class="book__face book__face--front">
                     <img src="${thumb.replace('http:', 'https:')}" alt="${title}">
@@ -282,7 +299,8 @@ class BookRenderer {
         if (!container) return;
         try {
             const keyParam = GOOGLE_API_KEY ? `&key=${GOOGLE_API_KEY}` : '';
-            const res = await fetch(`${API_BASE}?q=${query}&maxResults=${maxResults}&printType=books${keyParam}`);
+            const encodedQuery = encodeURIComponent(query);
+            const res = await fetch(`${API_BASE}?q=${encodedQuery}&maxResults=${maxResults}&printType=books${keyParam}`);
 
             if (!res.ok) {
                 throw new Error(`API Error: ${res.statusText}`);
@@ -602,6 +620,7 @@ class LibraryManager {
         }
         return null;
     }
+    // Issue #23: Implements removing a book from local array and database
     async removeBook(id) {
         const result = this.findBookInShelf(id);
         if (result) {
@@ -811,10 +830,28 @@ class GenreManager {
             const thumbnail = info.imageLinks ?
                 (info.imageLinks.thumbnail || info.imageLinks.smallThumbnail) :
                 'https://via.placeholder.com/128x196?text=No+Cover';
+            const categories = info.categories || [];
+
+            // Badge Logic
+            let badgesHTML = '';
+            const isNew = book.date_added && (new Date() - new Date(book.date_added)) < (7 * 24 * 60 * 60 * 1000);
+            const isPopular = info.ratingsCount && info.ratingsCount > 1000;
+            
+            if (isNew || isPopular || categories.length > 0) {
+                badgesHTML += '<div class="book-badge-container">';
+                if (isNew) badgesHTML += '<span class="book-badge badge-new">New</span>';
+                if (isPopular) badgesHTML += '<span class="book-badge badge-popular">Popular</span>';
+                if (categories.length > 0) {
+                    const mainGenre = categories[0].split(' / ')[0]; // Take first category part
+                    badgesHTML += `<span class="book-badge badge-genre" title="${mainGenre}">${mainGenre}</span>`;
+                }
+                badgesHTML += '</div>';
+            }
 
             const card = document.createElement('div');
             card.className = 'genre-book-card';
             card.innerHTML = `
+                ${badgesHTML}
                 <img src="${thumbnail}" alt="${title}" loading="lazy">
                 <div class="genre-book-info">
                     <h4>${title}</h4>
@@ -908,7 +945,7 @@ document.addEventListener('DOMContentLoaded', async () => {
     }
 
     const searchInput = document.getElementById('searchInput');
-    const searchIcon = document.querySelector('.search-icon'); // Or better, get the one inside search-bar if generic
+    const searchIcon = document.querySelector('.search-bar .search-icon');
 
     const performSearch = () => {
         if (searchInput && searchInput.value.trim()) {
@@ -946,9 +983,9 @@ document.addEventListener('DOMContentLoaded', async () => {
             </section>`;
         renderer.renderCuratedSection(query, 'search-results', 20);
     } else if (document.getElementById('row-rainy')) {
-        renderer.renderCuratedSection('subject:mystery+atmosphere', 'row-rainy');
-        renderer.renderCuratedSection('authors:amitav+ghosh|authors:arundhati+roy|subject:india', 'row-indian');
-        renderer.renderCuratedSection('subject:classic+fiction', 'row-classics');
+        renderer.renderCuratedSection('subject:mystery atmosphere', 'row-rainy');
+        renderer.renderCuratedSection('authors:amitav ghosh|authors:arundhati roy|subject:india', 'row-indian');
+        renderer.renderCuratedSection('subject:classic fiction', 'row-classics');
         renderer.renderCuratedSection('subject:fiction', 'row-genre');
     }
 
@@ -1320,3 +1357,4 @@ if (document.readyState === 'loading') {
 } else {
     KeyboardShortcuts.init();
 }
+