Welcome to BiblioDrift! This comprehensive tutorial will guide you through discovering your next great read in our cozy, visual-first book discovery platform.
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.
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.
- "Zero UI Noise": Clean, distraction-free browsing experience
- Tactile Interaction: 3D books you can pull from shelves and flip over
- Vibe-First Discovery: Search for feelings like "rainy mystery" or "cozy adventure"
BiblioDrift works right out of the box! No complex setup required.
-
Clone the repository:
git clone https://github.com/devanshi14malhotra/bibliodrift.git cd bibliodrift -
Open in browser:
- Simply open
index.htmlin your web browser - That's it! Start exploring books immediately
- Simply open
If you want to enable AI-powered book notes and recommendations:
-
Install Python dependencies:
pip install flask flask-cors
-
Start the backend server:
python app.py
The server will run on
http://localhost:5000 -
Update the frontend:
- Modify
app.jsto point to your local API instead of placeholder vibes
- Modify
When you first open BiblioDrift, you'll land on the Discovery page with three curated sections:
- Theme: Mystery & Melancholy
- Perfect for: Cozy indoor days, reflective moods
- Features books with atmospheric, introspective vibes
- Theme: Voices from the Subcontinent
- Highlights: Works by Indian authors and stories set in India
- Showcases diverse perspectives and cultural narratives
- Theme: Timeless & Dust-free
- Features: Enduring literary works that deserve rediscovery
- Curated classics that have stood the test of time
Each book in BiblioDrift is a 3D interactive element:
- Action: Move your mouse over any book
- Effect: The book gently pulls forward from the shelf
- Purpose: Get a quick glimpse without committing to a full view
- Action: Click on any book
- Effect: Book flips open to reveal detailed information
- What you'll see:
- Smooth Shimmer Loading: You'll see modern skeleton loaders while the AI fetches specialized book insights.
- AI-Generated Blurbs: Personalized summaries generated specifically for your mood.
- Interactive Back Cover: Click the "Flip" instruction to see the physical back of the book with its synopsis.
- Library Management: Use the compact action buttons to move books between shelves or share them with friends.
- Full synopsis and AI-generated vibe notes
- User reviews and ratings
- Emotion Tagging: A new section where you can mark how a book makes you feel (e.g., Cozy, Tense, Whimsical).
BiblioDrift’s standout feature is its ability to organize your library by feelings.
- Open your My Library page.
- Click on any book to open its detail modal.
- Locate the "How does this book make you feel?" section.
- Toggle different emotions. These are saved instantly to your profile!
Once you’ve tagged your collection, you can find the perfect book for your current mood:
- Search by Feeling: Type a mood like "Cozy" into the search bar at the top of the library. Only books matching that vibe will remain on the shelves.
- Sort by Mood: Select "Sort by Mood" from the sorting dropdown. Your library will reorganize itself, grouping similar emotional journeys together.
- Visual Cues: Look at the spines of your 3D books! Small icons will appear on books you've tagged, giving you a quick visual guide to your library's emotional landscape.
Once a book is flipped open, you'll see two action buttons:
- ❤️ Add to Library: Save the book to your personal virtual library
- ↻ Flip Back: Return the book to its shelf position
BiblioDrift's search is designed for emotional discovery:
- Click in the search bar at the top of the page
- Type your feeling or vibe (not just keywords!)
- Press Enter
Try these emotional searches:
"rainy afternoon mystery""cozy winter evening""adventurous escape""thoughtful contemplation""heartwarming family"
- Results appear in a clean, focused layout
- Each book maintains the same interactive 3D features
- Bookseller notes provide personalized recommendations
Your personal book sanctuary, organized like a real bookshelf.
- Click "My Library" in the navigation bar
- Or visit
library.htmldirectly
- Purpose: Books you're actively reading
- Empty state: "Your nightstand is empty..."
- Use when: You've started a book and want to track your progress
- Purpose: Books you want to read in the future
- Also known as: "Want to Read" or "TBR" (To Be Read)
- Use when: You find interesting books but aren't ready to start them yet
- Purpose: Books that have become special to you
- Use when: You've finished a book and want to remember it forever
- Find a book on the Discovery page or through search
- Click the book to flip it open
- Click the heart icon (❤️) to add to library
- Choose your shelf from the popup menu:
- "Currently Reading"
- "Want to Read"
- "Finished/Favorites"
- Books appear as 3D elements on their respective shelves
- Each book shows its cover and maintains interactive features
- Click any book to see details and move between shelves
- Books are saved locally in your browser
- Your library persists between sessions
- No account required—your data stays private on your device
- Location: Leaf icon floating on the right side of the screen
- Function: Toggle immersive background sounds (Rainy Evening or Cozy Fireplace)
- Features: Independent volume control to perfect your reading atmosphere
- Location: Moon icon in the top-right corner
- Function: Switch between light and dark themes
- Persistence: Your theme preference is remembered
- Discovery: Browse curated books and search
- My Library: Access your personal book collection
- Sign In: Authentication (planned feature)
- BiblioDrift works beautifully on:
- Desktop computers
- Tablets
- Mobile phones
- The 3D book interactions adapt to touch devices
- When: Scroll down the page
- Where: Arrow button appears in bottom-right corner
- Action: Smooth scroll back to the top of the page
BiblioDrift follows a strict AI-only recommendation policy:
- All book suggestions are generated by AI
- No manual curation or static lists
- Recommendations based on emotional and atmospheric cues
The app uses the Google Books API for real-time book data:
- Millions of books available
- Up-to-date information
- High-quality cover images
Your library is saved locally:
- No internet connection required for saved books
- Privacy-focused (data stays on your device)
- Automatic backup and restore
- Cause: Google Books API connection issue
- Solution: Check your internet connection and refresh the page
- Fallback: Books will show placeholder covers if images fail to load
- Cause: Empty search query or API timeout
- Solution: Try different search terms or refresh the page
- Tip: Use emotional/vibe-based searches for best results
- Cause: Browser storage disabled or full
- Solution: Enable local storage in browser settings
- Alternative: Try a different browser
- Cause: Older browser or hardware acceleration disabled
- Solution: Update your browser or enable hardware acceleration
- Fallback: Books still display correctly, just without 3D effects
Instead of searching "thriller," try:
"tense psychological mystery""heart-pounding suspense""noir detective story"
- Rainy days: Search for "atmospheric melancholy"
- Travel: Try "adventurous journey"
- Comfort: Look for "heartwarming cozy"
- Start with 2-3 books per shelf to avoid overwhelm
- Use "Currently Reading" for active engagement
- Move books between shelves as your relationship with them evolves
- Rainy Evening Reads: Perfect for introspection
- Indian Authors: Discover diverse voices
- Forgotten Classics: Timeless literary experiences
BiblioDrift is continuously evolving. Planned features include:
- AI Bookseller Notes: Personalized recommendations for every book
- Reading Progress Tracking: Mark chapters, add notes
- Social Features: Share discoveries with friends
- Advanced Search: Filter by mood, length, complexity
- Reading Lists: Create custom themed collections
- Issues: Report bugs on GitHub
- Features: Suggest improvements via GitHub Issues
- Contributing: See CONTRIBUTING.md for guidelines
Happy reading! May you find yourself in the pages. 📖✨