The act of acquiring books and letting them pile up unread (relatable for manga fans 😆)
Tsundoku is a mobile application built with React Native and Expo that helps manga enthusiasts discover, track, and organize their manga reading lists. The app integrates with popular manga services to provide a seamless reading experience.
- Browse and search manga from multiple sources (MangaDex, Mangahere (Coming Soon), and more...)
- Track your reading progress
- Create custom reading lists
- Clean and intuitive user interface
- Cross-platform support (iOS and Android)
- Node.js (v16 or higher)
- npm or yarn
- Expo CLI (
npm install -g expo-cli) - iOS Simulator (for Mac users) or Android Studio (for Android development)
-
Clone the repository:
git clone https://github.com/kennethsolomon/tsundoku.git cd tsundoku -
Install dependencies:
npm install # or yarn install -
Start the development server:
npx expo start
-
Run on your device or simulator:
- For iOS (Mac only):
npm run ios # or yarn ios - For Android:
npm run android # or yarn android
- For iOS (Mac only):
-
Install Xcode (for iOS development, Mac only):
- Download from the Mac App Store
- Install iOS Simulator through Xcode
-
Install Android Studio (for Android development):
- Download from https://developer.android.com/studio
- Set up an Android Virtual Device (AVD)
-
Configure environment variables:
- Copy
.env.exampleto.env - Fill in required API keys and configuration
- Copy
- Prebuild Native Files
npx expo prebuild- Open Xcode Project
open ios/my-app.xcworkspace- Build and Run in Xcode
- Connect an iPhone or use the simulator.
- Set up signing with an Apple Developer account.
- Click Run to build and test.
- Prebuild Native Files
npx expo prebuild- Open Android Project in Android Studio
cd android
./gradlew assembleRelease- Generate APK
- Open the project in Android Studio.
- Select Build → Build Bundle(s)/APK(s) → Build APK.
- The APK will be available in android/app/build/outputs/apk/release/.