Skip to content

Paulius11/simple-epub-reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple EPUB Reader

A modern, web-based EPUB reader built with React. Features a clean interface, dark/light themes, full-text search, and distraction-free reading mode.

GitHub Description: Web-based EPUB reader with search, themes, and distraction-free mode

🚀 Quick Links

Live Demo GitHub Repository GitHub Stars

✨ Features

  • 📚 EPUB File Support - Upload and read EPUB files directly in your browser
  • 🔍 Full-Text Search - Search across all chapters with highlighted results
  • 🌓 Dark/Light Mode - Toggle between themes for comfortable reading
  • 📖 Reading Modes - Switch between normal and distraction-free fullscreen mode
  • ⌨️ Keyboard Navigation - Use arrow keys to navigate between chapters
  • 📱 Responsive Design - Works seamlessly on desktop and mobile devices
  • 🎨 Modern UI - Clean interface with smooth animations and gradients

🛠️ Installation

  1. Clone the repository:
git clone https://github.com/Paulius11/simple-epub-reader.git
cd simple-epub-reader
  1. Install dependencies:
npm install
  1. Start the development server:
npm start

📦 Deployment & Updates

Deploy to GitHub Pages:

npm run deploy

Update GitHub Pages (after making changes):

  1. Make your changes
  2. Commit and push to main branch:
git add .
git commit -m "Your update message"
git push
  1. Deploy the updates:
npm run deploy

The site will update automatically at https://paulius11.github.io/simple-epub-reader

🔧 Technologies Used

  • React 19
  • Lucide React (icons)
  • JSZip (EPUB parsing)
  • CSS Custom Properties (theming)
  • GitHub Pages (hosting)

📝 Usage

  1. Click "Choose EPUB File" to upload an EPUB book
  2. Navigate chapters using:
    • Previous/Next buttons
    • Chapter dropdown selector
    • Arrow keys (← →)
    • Click on left/right edges in reading mode
  3. Search for text using the search bar
  4. Toggle between light/dark themes
  5. Enter reading mode for distraction-free experience

🤝 Contributing

Contributions are welcome! Feel free to:

  • Report bugs
  • Suggest new features
  • Submit pull requests

📄 License

This project is open source and available under the MIT License.

👤 Author

Paulius11


⭐ If you find this project useful, please consider giving it a star on GitHub!

About

simple epub reader with text search functionality

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published