Skip to content

usertest: Dutch (and other languages) in the user-testing app (#198) - #204

Merged
michielbdejong merged 1 commit into
mainfrom
claude/usertest-dutch
Sep 29, 2026
Merged

michielbdejong merged 1 commit into
mainfrom
claude/usertest-dutch

Conversation

@michielbdejong

Copy link
Copy Markdown
Contributor

Closes #198. Builds on #202 (typed answers).

  • Language choice: a new page/i18n.js holds the language list, each with a flag (🇬🇧 English, 🇳🇱 Nederlands), and every page text: instructions, consent, the typed-answer box and notices. A language comes from the buttons, from &lang=nl in the link, or from the last choice remembered in the browser.
  • Switching changes the page texts at once. Speech recognition restarts in the new language, with its voice (nl-NL, else nl-BE, else the default). Switching back to English mid-session restores everything.
  • The moderator is told through POST /sessions/<id>/lang. Every turn carries a [Language] line, and script.md tells it to speak that language and translate the tasks. Findings stay in English.
  • Recording: meta.json records lang and langChanges, and the transcript notes each switch.
  • Not covered: the Atomic app's own interface stays in English, because the data browser has no Dutch translation (it has English, Spanish, French and German). The Dutch instructions tell the tester so.

Tested locally:

  • the moderator, with a dummy key and a local stand-in for the Claude API: switching nl → en → nl, and an unknown language refused with 400;
  • the page, with &lang=nl and a mid-session switch to English.

Not verified: real speech recognition in English or Dutch, a real Chrome screen-share session, and a Dutch-speaking tester. Deployment to the droplet isn't included.

🤖 Generated with Claude Code

The session page gets a language switch at the top (English, Nederlands;
the list lives in page/i18n.js with a flag per language), also reachable
as `&lang=nl` in the invite link and remembered per browser. Switching
changes the page's texts and tester instructions, including the
typed-answer box (label, placeholder, Send, the "your turn" and "the
microphone is not working" notices, "You (typed)"), the speech
recognizer's language, the interviewer voice (nl-NL, else nl-BE, else
the default) and the moderator's language, also mid-session; switching
back to English restores all of it from the next line on.

The page tells the moderator with POST /sessions/<id>/lang. Every turn
carries a `[Language]` line, so the system prompt (script and English
session plan) stays the same and cached; script.md now says to speak
that language and translate the plan's tasks. meta.json records `lang`
and `langChanges`; the transcript records each switch and each tester
turn's language; analyze.mjs still writes its findings in English.

Not done: the Atomic app's own UI stays English, because the
data-browser has no Dutch translation (en, es, fr, de only).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@michielbdejong
michielbdejong merged commit c3ece22 into main Sep 29, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

in the user testing app, properly support other languages (starting with Dutch)

1 participant