A cross-platform, third-party Japanese Study App for Wanikani

Hakubun is a Japanese learning app that can be used with Wanikani, an SRS-based Japanese learning service. Learn and review radicals, kanji, and vocabulary, easily search for subjects, and explore content across levels.

The iOS and web versions are still being tested, but the alpha version Android is available on the Play Store through early access!

• Use swipe gestures or keyboard shortcuts to submit or retry answers
• Cross-platform, web-based app with native-like interactions and animations

• Review or learn by subject
  • Radical, kanji, vocabulary, kana vocabulary
• Select specific items to review or learn
• Shuffle or sort by SRS stage, level, available date
• Option to filter subjects by current level
• Typo tolerance

• Back to back ordering: change card order in queue
  • Meaning then reading
  • Reading then meaning
  • Disabled (shuffled)
• Wrap-up mode: finish up the reviews you started on, unreviewed are removed from queue

Hakubun uses Logrocket, a log collecting tool, to detect common errors that users are experiencing.

This means the following information may be stored:

• Username
• Errors encountered
• User actions in app (for example: how often user visits a page)

The following information is NOT stored and I will never be able to access to it:

• API tokens
• User location data
• User's name or other sensitive data

Please email me if you have any questions or concerns about how/what data is stored.

Make sure to run npm install before trying the steps below!

Building using this method for general development is highly recommended over the iOS and Android methods, it's much easier to debug and inspect changes. Running the app with iOS and Android simulators is only recommended to double-check that the changes you made are compatible with both platforms.

Start server:

npm run start

The app should then be available at http://localhost:5173/

If below doesn't work, check that network URL after displayed after running npm run start-exposed matches the URL in the capacitor.config.ts file

Start server in one terminal:

npm run start-exposed

Then run the script for the platform in another terminal:

npm run ios-live-reload

You can then select the type of iOS device you'd like to use as a simulator

• If you've never done this before, you'll likely have to the make sure "Show features for web developers" is enabled under Safari's Settings

  

• Open Safari and click the iOS simulator for Hakubun under Develop -> iOS device you chose as simulator -> IP address displayed. If this is not displayed, make sure you followed the previous step. If it's still not displayed, opening Xcode can sometimes make it appear

npm run android-live-reload

• In Chrome, go to chrome://inspect/#devices
• An address should be available under "Remote Target", you can click on "inspect" to bring up a web inspector. This can be used to inspect elements and view console output

Fastlane is a tool used to build the Android and iOS apps for Hakubun

To run android lanes:

fastlane android <LANE>

To run iOS lanes:

fastlane ios <LANE>