WaniKani Kanji SRS
A Spaced Repetition System (SRS) app for learning Japanese kanji using WaniKani’s API.
Test your kanji meanings, readings, and recognition skills on your mobile device.
📱 Features
- Quiz modes:
- Kanji → English: Guess the meaning of the kanji.
- English → Kanji: Match the meaning back to the kanji.
- Reading: Practice on’yomi and kun’yomi readings.
- Multiple-choice answers with dynamic distractors.
- Score tracking for correct and attempted answers.
- Clean and responsive Flutter UI with animated kanji cards.
- Fully offline-capable once deck is fetched and cached.
- Customizable themes (dark mode by default).
- Settings page to manage your WaniKani API key.
🛠️ Tech Stack
- Flutter for cross-platform mobile development (Android/iOS)
- Provider for state management
- Shared Preferences for storing API key and settings
- Dart for core logic
- WaniKani API for fetching kanji data
⚡ Installation
- Clone the repository:
git clone https://git.crylia.de/Crylia/wanikani-kanji-srs.git
cd wanikani_srs
- Install dependencies:
flutter pub get
- Run on a device/emulator:
flutter run
- Set your WaniKani API key in the app’s settings to fetch your deck.
🔧 Usage
- Open the app and enter your WaniKani API key.
- Select a quiz mode:
- Kanji → English
- English → Kanji
- Reading
- Tap on the multiple-choice options to answer.
- Your score is displayed at the bottom.
- Progress is updated automatically.
📦 Build APK
To generate a release APK:
flutter build apk --release