Milaki Back to home

Accessibility

Last updated: [DATE]. Last accessibility review: November 6, 2026 (an internal review of the web app by our team; not an outside audit).

We want Milaki to be usable by as many people as possible, including people who use screen readers, keyboards, magnification, or voice control. This page says what we aim for, what works today, and what does not work yet.

Our commitment

We aim to conform to the Web Content Accessibility Guidelines (WCAG) [CONFIRM: 2.1 vs 2.2] Level AA for the Milaki web app, and to follow Apple’s accessibility guidelines for the iPhone app. We are working toward that target. We do not claim to meet it today.

What works today

[VERIFY: each item below against the shipped build and design/reviews/a11y-audit-2026-11-06.md; 00-facts.md confirms only the spec targets (contrast, text size presets, 44 pt targets, named icon-only controls, keyboard focus order, reduced motion).]

  • Text size. Milaki follows your device’s text size setting (Dynamic Type on iPhone, browser zoom up to 200% on the web). On top of that, you can choose a story text size (three steps) or set one yourself in Settings.
  • Contrast. We design text to reach a contrast ratio of at least 4.5:1, and large text, icons, and focus outlines at least 3:1, in every color theme. We check these pairs with an automated test.
  • Reduced motion. We respect your device’s reduce-motion setting. Meaning is never carried by motion alone.
  • Touch targets. Buttons are at least 44 by 44 points on iPhone [VERIFY: 48 by 48 dp applies to Android only, which is not in scope].
  • Labeled controls. Icon-only buttons, such as Play, Pause, Text size, and Close word help, have names a screen reader can read.
  • Not color alone. The sentence being read aloud is shown with a tint plus an underline or weight, and new words use dotted underlines.
  • Greek language tagging. Greek text is marked as Greek so assistive tools can pronounce it correctly. We found a few places where it is not yet [VERIFY].
  • Keyboard on the web. You can reach most of the web app with Tab, move between words in a story with arrow keys, open word help with Enter or Space, and close panels with Escape. Panels keep focus inside while open.
  • Audio always has text. Narration never stands alone. The Greek text is on screen line by line, and the sentence being read is highlighted.
  • Drag is never the only way. Exercises you can drag can also be done with taps or keyboard controls [VERIFY: shipped state].

Known limitations

We would rather tell you than have you find out.

  • Not yet tested with screen readers on a device. We have not completed full VoiceOver testing on iPhone, or NVDA and other screen reader testing on the web. A VoiceOver pass on the iPhone app is planned before App Store submission [CONFIRM]. Until then, parts of the app may not read well aloud.
  • Keyboard gaps on the web. Our November 2026 review found that some navigation items (tab bar, top menu, Settings button) do not respond to Enter or Space, that keyboard focus can jump back to the top of the page after some actions, and that option groups (such as theme or text size) do not respond to Space or arrow keys as expected. We are fixing these now [VERIFY: update status at publish time].
  • Silent changes. In some activities, such as the vocabulary check, the next word changes without a screen reader announcement. We are fixing this.
  • Reading by sentence. A screen reader may read the Greek passage word by word. We are changing it so each sentence can be heard whole [VERIFY: shipped state].
  • Moving elements. A few small decorative animations on the home screen may keep moving longer than they should; we are limiting them.
  • Audio. Narration is a recording, not live speech, and there are no sign-language versions. Greek text with translations is shown, but there is no separate downloadable transcript [VERIFY].
  • Quiet audio bar. The audio controls fade while audio plays, and we are setting a minimum visibility so they remain readable.
  • Third-party content. Some story audio comes from volunteer recordings, whose quality we do not control.
  • Greek content. Many stories are AI-drafted and may contain language mistakes. See "How Milaki uses AI".

Tell us what is not working

If something in Milaki is hard or impossible for you to use, please write to [PLACEHOLDER: support@milaki.app] (subject line "Accessibility"). Tell us what you were trying to do, the device or browser, and any assistive technology. You do not have to write in any special way, and you can ask for help in another format.

We will reply within [CONFIRM: 5 business days]. We will tell you what we plan to do, and if we cannot fix it, we will try to suggest another way to do what you need.

Compatibility

  • iPhone: iOS 18 and later.
  • Web: current versions of Chrome, Safari, Firefox, and Edge [VERIFY: browsers tested; the audit used Chromium only].
  • Milaki relies on standard web and iOS accessibility features, including system text size, zoom, reduced motion, and (once tested) VoiceOver.