GraphQL Day

Server Assisted Accessibility: Embedding UI Semantics Into Your GraphQL Schema + CI

GraphQLAccessibility

Accessibility is often an afterthought or is left until the last milestone before a feature ships. What if we shifted that left? This talk showcases a sandbox idea: embedding accessibility metadata directly into GraphQL schemas using custom directives and code generation. This enables clients (Android, iOS, and web) to get accessible defaults from day one.

We'll cover the directive design, how to expose metadata in generated types, and how frontends like Jetpack Compose or SwiftUI consume it. We'll walk through a practical, low friction approach: adding CI friendly validation that catches common contract regressions before changes ship, such as missing required metadata, invalid values, and template drift.

You'll leave with schema snippets you can copy & paste, strategies to introduce this in your own APIs, and a blueprint for making accessibility part of your developer experience. A repository with working code examples will be provided.


Vanessa Johnson

The New York Times, Android Engineer