# MangaVerse Mobile Reader

> MangaVerse is a modern, high-performance multi-source comic and manga reader application designed for Web, Android, iOS, and Desktop.

## Overview
- **Product Name**: MangaVerse
- **Version**: 2.0.0
- **Category**: Comic Reader, Web Comic Viewer, PWA, Mobile Application
- **License / Cost**: 100% Free, no hidden fees, no mandatory user registration
- **Official URL**: https://mangaverse.tienlv.com
- **Repository / Tech**: Node.js, Express, Ionic Framework, Capacitor, Cheerio, Vanilla CSS Glassmorphism 2.0

## Core Capabilities
1. **Multi-Source Scraping**: Extensible architecture implementing `IComicSource` interface for seamless source swapping (NetTruyen, BlogTruyen, MangaDex).
2. **Anti-403 Image Proxy**: Dedicated streaming proxy service injecting required `Referer` and `User-Agent` headers to guarantee 100% image load success without CDN 403 Forbidden errors.
3. **Native 60fps Mobile Experience**: Powered by Ionic Framework components, iOS momentum scrolling, tactile haptics, spring physics, and pull-to-refresh gestures.
4. **Clean Reading Experience**: Free of deceptive ads, popup redirects, and crypto miners.
5. **Offline & State Persistence**: Automatic chapter progress tracking, offline history caching via IndexedDB/LocalStorage.

## Available APIs
- `GET /api/home?page=1`: Fetch latest home releases and featured comic recommendations.
- `GET /api/hot?page=1`: Fetch trending and hot comics across sources.
- `GET /api/rankings?sort=10`: Top all-time, monthly, and daily manga rankings.
- `GET /api/sources`: List of available comic source providers and real-time status.
- `GET /api/search?q={query}`: Search comics by title or keyword.
- `GET /api/comic?url={comicUrl}`: Detailed comic metadata, genre tags, and chapter list.
- `GET /api/chapter?url={chapterUrl}`: Continuous list of chapter image pages with anti-watermark filtering.
- `GET /api/image-proxy?url={rawImageUrl}`: Secure streaming image proxy.

## Frequently Asked Questions (FAQ)
- **What is MangaVerse?** MangaVerse is an ad-free, high-speed comic reader app allowing users to read manga, manhwa, and manhua from multiple online providers in a unified, modern interface.
- **Is MangaVerse free?** Yes, MangaVerse is completely free to use without requiring user accounts or credit cards.
- **How does MangaVerse bypass 403 Forbidden image errors?** Through an in-house backend image proxy service that replicates browser headers and streams images directly to the client.
- **Which platforms are supported?** Web browsers (PWA), Android (APK/Google Play), iOS (Capacitor/App Store), and Desktop (Electron).