Skip to content

ArthurMathi/Bookflix

Repository files navigation

📚 BookFlix - Netflix for Books

A cinematic reading platform that combines Netflix's visual appeal with Letterboxd's social features to make reading feel joyful and engaging.

🎬 Features

Netflix-Style Experience

  • Hero Banner: Featured books with cinematic presentation
  • Horizontal Scrolling: Netflix-style book rows by category and mood
  • Dark Theme: Immersive reading-focused design
  • Smooth Animations: Framer Motion powered transitions

Letterboxd-Inspired Social Features

  • 5-Star Rating System: Rate and review books
  • Reading Diary: Track reading dates and personal notes
  • Mood Tagging: Tag books with emotions (Dark, Hopeful, Emotional, etc.)
  • Reading History: Timeline view of completed books

Book Discovery

  • Trending Books: Popular and new releases
  • Category Browsing: Fiction, Mystery, Romance, Sci-Fi, Fantasy, and more
  • Mood-Based Recommendations: Books that match your current feeling
  • Comic Hub: Dedicated section for comics, manga, and graphic novels

Personal Library Management

  • Bucket List: Want to Read, Currently Reading, Completed
  • Progress Tracking: Visual indicators for reading status
  • User Profiles: Reading stats, streaks, and achievements

🏗️ Technical Stack

  • Frontend: React 18 with Hooks and Context API
  • Styling: Custom CSS with Netflix-inspired design system
  • Animations: Framer Motion for smooth transitions
  • API: Google Books API for real book data
  • Routing: React Router v6
  • Storage: LocalStorage for MVP user data
  • Authentication: Simple email-based system

📱 Screens

  1. Splash Screen - Animated BookFlix branding
  2. Authentication - Login/Register with genre preferences
  3. Home - Hero banner + categorized book rows
  4. Categories - Browse books by genre
  5. Comic Hub - Comics, manga, and graphic novels
  6. Book Detail - Complete book information and actions
  7. Review/Diary - Write reviews with mood tags
  8. Bucket List - Personal reading list management
  9. Reading History - Timeline of completed books
  10. Profile - User statistics and settings

🚀 Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd bookflix
  1. Install dependencies:
npm install
  1. Start the development server:
npm start
  1. Open http://localhost:3000 in your browser

📖 Usage

First Time Setup

  1. Register with your email and select favorite genres
  2. Browse trending books and categories
  3. Add books to your reading list
  4. Start reading and track your progress

Key Features

  • Add to List: Click the "+" button on any book card
  • Change Status: Update books from Planned → Reading → Completed
  • Write Reviews: Rate books and add mood tags
  • Browse Comics: Visit the Comic Hub for superhero and manga content
  • Track Progress: View your reading history and statistics

🎨 Design Philosophy

BookFlix treats books like cinema - visual, emotional, and social. The platform is designed to:

  • Make reading feel as engaging as watching Netflix
  • Provide social features similar to Letterboxd for movies
  • Remove boredom from reading through gamification
  • Create a cinematic, joyful reading experience

📚 Book Categories

Regular Books

  • Fiction & Literature
  • Mystery & Thriller
  • Romance
  • Science Fiction
  • Fantasy
  • Historical Fiction
  • Biography
  • Self-Help
  • Business
  • Health & Fitness
  • Cooking
  • Travel

Comics & Graphic Novels

  • Superhero Comics
  • Marvel Universe
  • DC Comics
  • Manga
  • Dark Horse Comics
  • Image Comics
  • Graphic Novels
  • Webcomics

🔮 Future Enhancements

  • Audiobooks Integration
  • AI-Generated Book Trailers
  • Reading Clubs & Social Rooms
  • Author Live Sessions
  • Advanced Recommendation Engine
  • Mobile App (React Native)
  • Social Following System
  • Book Challenges & Goals

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Google Books API for providing book data
  • Netflix for UI/UX inspiration
  • Letterboxd for social features inspiration
  • Framer Motion for smooth animations
  • React Community for excellent documentation

BookFlix - Making reading as addictive as binge-watching! 📚✨

About

Ott Platform for books

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors