[iOS] - Relay Cards: native app with multiple choice, daily review batches

[audentia]

Hey everyone, wanted to share a new app I just released ‎Relay Cards App - App Store

Why not Tsurukame? Tsurukame is, I believe, the most popular current iOS app and is a wonderful creation which I admire, however I wanted to do a few things differently.

1. I want easy mode - multiple choice. I don’t want to type while on the phone. So if you want that too, please check it out. I also allow picture hints and audio hints during lessons. You can keep it pure too though if you like.
2. I wanted to batch reviews. One of the things that killed my motivation with the regular website or any wani kani client was seeing 100+ reviews daily. I just don’t have time for that. I started to give up. Using my own app, I can set daily review batches (as well as lesson batches, as the API supports) the review batches logic is on device, separate from the wani kani API, but everything else is API driven. I developed a daily habit again which I quite like.
3. I love ruthlessly simple things, Tsurukame just always felt cluttered to me, I’m not trying to replicate every feature or every possible user script, just an easy way to get your daily’s while on the go. I don’t have all the stats and stuff, you can check the website for that is what I’m thinking, but feel free to change my mind.
4. Native + multi-platform, using a modern SwiftUI codebase, I can support mac, iPad, and iPhone, and have plans for Vision Pro and the Watch down the way, because why not. Swift also compiles to Android these days, so I am working on an Android version. Oh and your API key syncs securely with iCloud, so once you sign in once, all your apple devices will login automatically, yay!
5. Always free. The app will always be free for a complete wanikani experience, thats important to me both as a user and to respect what wanikani has created. To be completely transparent, I have some ideas for paid features in the future around Japanese language learning, but separate from the waniKani experience, one possible idea importing and integrating Anki decks. Open to hearing thoughts about that.
6. Why the turtle? Of course Tsurukame was an inspiration, perhaps even subconsciously, but actually I love turtles, and something silly seemed to fit the vibe of the crabigator.

If any of this resonates with you, please try it out, and please reply here with comments what you love, what you hate, or whatever. Cheers.

[Megatron]

This is awesome!

[asdyrocks]

Hey there! Looks promising!

However I can’t configure it to use my token I have checked and I’m 100% sure the token is correct but seems like it can’t be decoded.

Any help would be appreciated Thanks!

[audentia]

Hey! thanks for reaching out and sharing, really sorry about this. It seems that for some reason your account / token is returning a different structure JSON than what the app is expecting, which is why it fails to load. I’m not sure why that would happen, I had assumed all accounts function the same. Hmm, I’m trying to think how to debug it for you, i intentionally have no access to your key, your data, etc, so I can’t see whats different.

Oh, one idea, when you created the token on wani kani’s website, did you allow it all access? It needs every box checked to work, since it both reads and writes to account, reviews, and lessons etc. Let me know if that helps.

[asdyrocks]

Hi!

Thanks for the quick response!

Yes, I gave full access. Just to be sure, I must just copy the string token right?

I use Tsurukame app fine so I guess there’s no issues with my account.

Is there a way to decode the token myself? I’m a developer as well and maybe I can do it somehow to see the error.

Update: I did tried fetching my data from Postman using my token and it was successful:

[audentia]

OK I see, yes the token just like Tsurukame, Postman, etc. should “just work” in Relay Cards as well. There must be some variation I haven’t taken account for.

Oh great, can you share with me the entire json you’re getting back from postman? then I should be able to fix it quickly. You can DM me if thats better to not clutter up this forum. Also i will be adding some more logging and debugging into future builds. I will make a test flight build soon so you can test that.

[asdyrocks]

Perfect! I DMd you on reddit (I first saw your post there and I don’t know how to send DMs here )

[audentia]

ok great! I see it, haha me neither actually

[audentia]

Quick update - 1.0.1 is out on the app store which fixes the bug (which we discovered was isolated to versions of iOS before 26) In any case, now whether iOS 17, 18, or 26 should not have that issue anymore. Thanks @asdyrocks for helping with the debugging.

some other fun things 1.0.1 adds is more of the native website dashboard features, iCloud syncing more of your stuff like daily’s and streaks, and some UI fixes. It also introduces widgets! so you can keep track of basic stats anywhere.

I’m working on 1.0.2 now which has better keyboard support (just type and press enter, it will auto advance now) and will expand platform support to visionOS, tvOS, and watchOS. And… Android! with a whole rebuild of the cross-platform Skip architecture, it uses some shared swift code and then fully native SwiftUI and Jetpack Compose for each platform respectively.

[Megatron]

Great work!

[audentia]

Thank you! I’m pleased to say 1.0.3 is out now, and now supports every apple platform including widgets and iMessage apps. Send a message to your friend challenging them to know a particular kanji.

This has been a goal of mine ever since SwiftUI enabled multi-platform development. Now, why would you want to study Kanji on your giant 4K TV? or your tiny Apple Watch? I dunno, but now you can. The crabigator must be pleased. Sadly, Android is taking me more time than expected, more on that later.

More importantly, the app is basically feature complete now

- search entire wanikani database, save it to your device for offline viewing

- push notifications, get just one daily reminder to achieve your goals! it automatically will notify you the same time of day you did your lesson or review the previous day

- better loading and less redundant network calls made

- fuzzy logic detection, don’t need exact answers

- mark correct feature, if you just mistyped it, you can set it as correct (we all make mistakes on little keyboards, don’t cheat tho!)

- copy kanji by tapping on the large card

- view details of kanji anywhere in the app, add synonyms easily

- ui fixes, clean grids and flow layout of kanji cards across all platforms

Please let me know any feature requests or problems you may encounter, I want this to be the best wani kani experience. I think I’ve achieved that, personally I don’t use the website anymore, but please let me know.