zulip/zulip-flutter

Mark headings for semantics in inbox and recipient headers

Open

#1,964 opened on Nov 1, 2025

View on GitHub
 (4 comments) (0 reactions) (0 assignees)Dart (456 forks)github user discovery
a-a11ya-homea-msglisthelp wanted

Repository metrics

Stars
 (454 stars)
PR merge metrics
 (PR metrics pending)

Description

This was found in https://github.com/zulip/zulip-flutter/issues/535#issuecomment-2973276995 when investigating the app's behavior with a screen reader:

Headers should be marked as such. This includes recipient headers in the message list and the collapsible channel headings on the inbox page. This is probably quite important for the inbox page, since there can be difficulty telling channel and topic items apart.

We should fix this.

A required part of any PR to address this issue will be to try it out with a screen reader and confirm how it behaves. See the description of #535 for instructions.

Contributor guide

Research direction
Implement semantic headings for recipient headers and inbox channel headings using Flutter's Semantics widget. Test with a screen reader like TalkBack or VoiceOver to confirm correct behavior.
Tech stack
dartflutter
Domain
mobile
Issue type
Accessibility
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
Half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Mostly clear
Prerequisites
FlutterAccessibility testing
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60