A free, game-like Japanese learning app for Android. Short lessons, XP, streaks, hearts, combos, boss fights and spaced-repetition review, starting with hiragana and katakana.
- On your phone, open the latest release.
- Tap Michi.apk to download it.
- Open the downloaded file. If Android asks, allow your browser to "install unknown apps", then tap Install.
- New versions install over the old one and keep your progress.
No voice? Listening games use your phone's text-to-speech. Go to Settings > System > Languages > Text-to-speech output, pick Google, and install the Japanese voice.
- Lessons: 13 per script (vowels to combos like きゃ). Each one teaches the kana, then mixes games: read it, pick the kana, listen, type the reading, match pairs and trace strokes.
- Bosses: the Kana Oni (hiragana) and the Katakana Tengu. Beat one to unlock the next unit, or to skip ahead if you already know the kana.
- Review: Again / Hard / Good / Easy flashcards scheduled with spaced repetition.
- Chart: every kana coloured by how well you know it. Tap one to hear it, watch its stroke order and practice writing it.
- Light and dark mode (follows your phone, or pick one under Me).
Stack: TypeScript + Vite (no framework), wrapped as an Android app with Capacitor. Every push to main builds the APK in GitHub Actions and publishes it as a release.
npm install
npm run dev # open the app in a browser
npm test # unit tests
npm run build && npx cap sync android # then build android/ with Android Studio or ./gradlew assembleDebugsrc/data/kana.ts: kana, lessons and culture notessrc/lessonGen.ts: builds each lesson's question mixsrc/srs.ts: spaced-repetition schedulersrc/games.ts: the mini-games, including stroke tracingscripts/fetch-strokes.mjs: regenerates stroke data from KanjiVG
Credits: stroke data from KanjiVG by Ulrich Apel (CC BY-SA 3.0). Fonts M PLUS Rounded 1c and Shippori Mincho (SIL OFL).