appflowy-io/appflowy
Reviewed against Rams quality heuristics: accessibility, color, typography, spacing, components, motion, UX, and craft.
11 files reviewed·July 29, 2026
More findings
Verdict
A tiny fixture with one accessibility gesture that misses its own point: alt text exists but describes nothing. The fix is trivial, but as written it's decorative rather than functional.
Files Rams reviewed
frontend/appflowy_flutter/packages/appflowy_popover/example/web/index.html
frontend/appflowy_flutter/packages/flowy_infra_ui/example/web/index.html
frontend/appflowy_flutter/web/index.html
frontend/rust-lib/flowy-document/tests/assets/html/google_docs.html
frontend/rust-lib/flowy-document/tests/assets/html/notion.html
frontend/rust-lib/flowy-document/tests/assets/html/bulleted_list.html
frontend/rust-lib/flowy-document/tests/assets/html/callout.html
frontend/rust-lib/flowy-document/tests/assets/html/code.html
frontend/rust-lib/flowy-document/tests/assets/html/divider.html
frontend/rust-lib/flowy-document/tests/assets/html/heading.html
frontend/rust-lib/flowy-document/tests/assets/html/image.html
Accessibility
frontend/rust-lib/flowy-document/tests/assets/html/image.html:1
Image alt text is filler, not a description of the content
The <img> tag pointing to the Google logo (`googlelogo_color_272x92dp.png`) carries `alt=AppFlowy-Image`, an unquoted attribute value that describes neither the image's content nor its purpose. A screen reader user hears "AppFlowy-Image" for what is actually a Google logo, giving them no way to know what the image actually shows.
Why it matters
Screen reader users depend on alt text to understand non-text content; meaningless placeholder text breaks that path entirely and makes the image functionally invisible to them.
Fix
Quote the alt attribute and write a description that matches the actual image content.
<img src="https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png" alt=AppFlowy-Image /><img src="https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png" alt="Google logo" />Typography
Color
Spacing
Components
Motion
UX
Craft
Working well
- The <img> element does include an alt attribute at all, which puts it ahead of markup that omits alt entirely and leaves screen readers with nothing to announce.
Scored July 29, 2026 with Rams Engine v0.0.3 · Engine changelog
This page is an automated design review of appflowy-io/appflowy’s UI code: 11 files read against 258 versioned rules covering accessibility, color, typography, spacing, components, UX, motion, and craft. The score is out of 100; any confirmed critical issue caps it at 59.
More design scores
Score your own repo.
Free on public repos, no account. The same engine that scored this page reads your UI code and mints a score page like this one.
Public repos only. The full engine reviews the UI code and mints a public score page — we email you the link too. Already-scored repos open instantly.
