Character Game for a Daughter with ADHD Meets cj-tauri's Silent Failures and a Drift Bug
cj-tauri's documentation and tooling still carry gaps that cost a weekend: silent asset-loading failures, PATH-order dependencies, a missing DLL, and a drift bug that makes sync and check disagree. For anyone evaluating Cangjie or similar cross-platform frameworks, these exact failure modes and the author's fixes are directly reusable.
The game offers five mini-games with 102 character groups from grades one to five. Difficulty adapts by adding distractors on correct answers and showing a memory mnemonic after three misses. The parent dashboard tracks session time, accuracy trends, and automatically aggregates repeatedly missed pairs into a review area. Progress is saved via four Cangjie commands to a local JSON file, with a localStorage fallback.
Three silent environment and framework issues cost time: relative CSS and JS fail to load because the framework reads the HTML as a string and uses NavigateToString, solved by a build-time inliner; cjpm exits with 127 unless Cangjie's bin, tools, and runtime are first on PATH; and a missing WebView2Loader.dll makes the window close instantly. The author also traced a sync/check drift bug to TOML escaping and path normalization, fixed it, added regression tests, and documented the correct HarmonyOS signing order (sync, sign, build, never sync after sign).
The silent relative-path failure is a classic WebView2 behavior: NavigateToString provides no base URL, so any local CSS or JS reference is unresolvable; the build-time inline workaround is a simple, portable pattern for any WebView wrapper.
The A/B comparison against the base commit before touching existing failing tests is a good contributor habit: it separates pre-existing breakage from newly introduced regressions.
The signing-order trap (sync regenerates build-profile.json5 and wipes signingConfigs) is a footgun that any framework automating HarmonyOS packaging should document prominently or make idempotent.