[Docs]: Turn on web accessibility to assist humans and LLMs alike

[craiglabenz]

Documentation Type

Other

Documentation Location

All documentation

Issue Description

I have noticed that Gemini has almost no knowledge of pkg:shadcn_flutter's API surface, instead always recommending code that aligns with pkg:shadcn_ui's design. I theorize this is because this package's documentation does not have Flutter web's semantics system turned on, whereas pkg:shadcn_ui uses HTML which is accessible by default.

Current Content

Suggested Improvement

I recommend adding this line to the docs site to help Gemini and other crawlers ingest pkg:shadcn_flutter's documentation:

SemanticsBinding.instance.ensureSemantics();

Related Component

None

Target Audience

No response

Additional Context

No response

Checklist

• [x] I have searched existing issues to avoid duplicates
• [x] I have provided specific suggestions for improvement

[craiglabenz]

Relatedly, lazy widgets (while good for mobile performance) also hurt accessibility, since few crawlers know to scroll down. Since the total number of items is always known here (docs do not need infinite scroll), I would further advise against use of ListView.builder, instead favoring eagerly rendered widgets.

[sunarya-thito]

Hi, thank you for your advice and suggestion. Let me see what i can do.

[xXleowXx]

Hi, +1. Exactly what happened to me today. Had to explain to GPT5 how to use the Table and what arguments it takes.

[ysalitrynskyi]

Related to https://github.com/sunarya-thito/shadcn_flutter/issues/334

[sunarya-thito]

After a few attempts, it seems i wont be able to enable semantics for the docs/widget catalogs as its causing too many issues.

I do wonder tho if gemini supports llms-full.txt or able to read the package documentation

[craiglabenz]

What sort of issues are you running into? The Flutter web team would love to hear about these issues to get them resolved.

[craiglabenz]

Dotguides is another option.

[sunarya-thito]

What sort of issues are you running into? The Flutter web team would love to hear about these issues to get them resolved.

I'm experiencing issues with MouseRegion (and possibly other gesture widgets) after navigating to a new page. This seems to happen when using Navigator (I'm using GoRouter specifically).

Dotguides is another option.

I've set up the repository following the dotguides guide. I've also provided llms-full.txt just in case.

[sethladd]

I've set up the repository following the dotguides guide.

Cool, thank you!