A modern manga and adult Korean manhwa reading application built with React, Vite, and Tailwind CSS. Powered by the MangaDex API with full PWA support and native Android app.
- Browse popular manga and manhwa
- Real-time search with suggestions
- Category-based browsing
- Full-screen reader with keyboard navigation
- Auto-scroll to top when changing pages/chapters
- Web App - Works in any modern browser
- PWA - Install as app on mobile/desktop
- Android APK - Native Android app via Capacitor
- Responsive design for all screen sizes
- Modern UI with Tailwind CSS
- Fast performance with Vite
- Toast notifications
- Local storage for preferences
- Clean, intuitive interface
| Category | Technology |
|---|---|
| Frontend | React 19 |
| Build Tool | Vite 7 |
| Styling | Tailwind CSS v3.4 |
| Routing | React Router DOM v7 |
| HTTP Client | Axios |
| Icons | Lucide React |
| Mobile | Capacitor (Android) |
| API | MangaDex API |
- Node.js v18 or higher
- npm or yarn
# Clone the repository
git clone https://github.com/MineoreYT/InkStream.git
cd manga-app
# Install dependencies
npm install
# Start development server
npm run devOpen http://localhost:5173 in your browser.
npm run build
npm run preview- Visit the deployed site on your mobile browser
- Click "Add to Home Screen" or use the install prompt
- The app will be installed like a native app
The Android APK is automatically built via GitHub Actions when code is pushed to main.
- Go to the Actions tab on GitHub
- Find the latest successful build
- Download the
InkStream.apkartifact - Install on your Android device
InkStream includes a dedicated section for adult Korean manhwa with proper safeguards:
manga-app/
├── api/ # Vercel serverless functions
│ ├── manga.js # MangaDex API proxy
│ ├── chapter-proxy.js # Chapter image proxy
│ └── image-proxy.js # Cover image proxy
├── public/ # Static assets
│ ├── manifest.json # PWA manifest
│ └── sw.js # Service worker
├── src/
│ ├── components/ # Reusable UI components
│ ├── contexts/ # React contexts
│ ├── pages/ # Page components
│ └── services/ # API services
├── android/ # Capacitor Android project
└── .github/workflows/ # GitHub Actions (APK build)
| Command | Description |
|---|---|
npm run dev |
Start development server |
npm run build |
Build for production |
npm run preview |
Preview production build |
npm run lint |
Run ESLint |
npm run android:sync |
Sync Capacitor with Android |
npm run android:build |
Build Android project |
- Connect your GitHub repository to Vercel
- Vercel will auto-detect Vite and deploy
- Serverless functions in
/apifolder work automatically
No environment variables required - the app uses public APIs.
- MangaDex - Manga/Manhwa data and images
- API Docs: https://api.mangadex.org/docs/
- corsproxy.io - CORS proxy for chapter pages
- images.weserv.nl - Image proxy fallback
- React Team for the amazing framework
- Tailwind CSS for utility-first styling
- Vite for lightning-fast builds
- Capacitor for native mobile support
This project is for educational purposes. Please respect MangaDex's terms of service and the rights of manga creators and publishers.
This project is for educational and demonstration purposes only.
- All manga/manhwa content belongs to their respective copyright holders
- This application does not claim ownership of any displayed content
- Content is sourced through the public MangaDx API
- No copyright infringement is intended
This project demonstrates:
- Modern React development techniques
- Progressive Web App (PWA) implementation
- Mobile app development with Capacitor
- API integration and proxy implementation
- Responsive design with Tailwind CSS
- Not for commercial use - This is a non-commercial educational project
- DMCA Compliant - We respond to legitimate takedown requests
- User Responsibility - Users must comply with local copyright laws
- Age Verification - Proper safeguards for adult content
For detailed legal information, see LEGAL.md and TERMS.md.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Made with ❤️ by MineoreYT