Skip to content

docs(ui,llc): update sdk readmes#2724

Merged
renefloor merged 4 commits into
v10.0.0from
docs/update-readmes
Jun 9, 2026
Merged

docs(ui,llc): update sdk readmes#2724
renefloor merged 4 commits into
v10.0.0from
docs/update-readmes

Conversation

@renefloor

@renefloor renefloor commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Submit a pull request

CLA

  • I have signed the Stream CLA (required).
  • The code changes follow best practices
  • Code changes are tested (add some information if not applicable)

Description of the pull request

This updates the content and the structure of the readmes of the sdks and the repo. It also refreshes the banner.

Summary by CodeRabbit

  • Documentation
    • Comprehensive README updates across all packages with V10-oriented guidance and expanded feature descriptions.
    • Reorganized setup instructions, dependency snippets, and platform configuration guidance for improved clarity.
    • Added migration guide references, enhanced offline storage documentation, and updated contributing guidelines.

@coderabbitai

coderabbitai Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title 'docs(ui,llc): update sdk readmes' directly describes the changeset, which consists of README updates across multiple SDK packages and the main repository.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/update-readmes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov

codecov Bot commented Jun 4, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 68.16%. Comparing base (52aa76d) to head (7e3e3b1).
⚠️ Report is 17 commits behind head on v10.0.0.

Additional details and impacted files
@@             Coverage Diff             @@
##           v10.0.0    #2724      +/-   ##
===========================================
+ Coverage    67.84%   68.16%   +0.32%     
===========================================
  Files          411      413       +2     
  Lines        24632    24851     +219     
===========================================
+ Hits         16711    16940     +229     
+ Misses        7921     7911      -10     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 12

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/stream_chat_flutter_core/README.md`:
- Line 15: The "### Changelog" heading violates markdown hierarchy (MD001);
update the heading text "### Changelog" to a second-level heading "## Changelog"
so it fits the surrounding sections and resolves the lint error.
- Line 33: Replace the invalid placeholder dependency line in README.md so it’s
copy-pasteable: change "stream_chat_flutter_core: ^latest_version" to either a
real semver (e.g. "stream_chat_flutter_core: ^4.7.0") or an explicit placeholder
like "stream_chat_flutter_core: <latest_version>" and add a short note after the
snippet stating "<latest_version> must be replaced with a real version in your
pubspec.yaml"; update the README snippet near the dependency example to reflect
this change so users won’t get a pub resolution error when pasting.

In `@packages/stream_chat_flutter/README.md`:
- Line 17: Change the Changelog heading from "### Changelog" to "## Changelog"
in the README so heading levels are normalized; update the line containing the
"Changelog" heading text to use two hashes instead of three to avoid skipping
heading levels.
- Line 3: Replace the empty alt label in the hero image markdown with a
meaningful description to improve accessibility: update the
`![](https://raw.githubusercontent.com/GetStream/stream-chat-flutter/master/images/sdk_hero_v10.png)`
line in README.md to use a descriptive alt text (for example `![Stream Chat
Flutter SDK hero illustration showing chat bubbles and mobile device](...)`) so
the image token conveys its content to screen readers and markdown renderers.

In `@packages/stream_chat_localizations/README.md`:
- Line 112: In the README sentence starting "For translations to work on **iOS**
you need to add supported locales..." replace the non-descriptive anchor text
"here" with a meaningful label such as "Flutter docs: Localizing for iOS —
updating the iOS app bundle" (or similar descriptive text) so the link clearly
describes its destination; update the markdown link text while keeping the same
URL.
- Line 15: The "Changelog" heading uses "### Changelog" which skips a level
after the README H1; update the heading to "## Changelog" so the markdown
heading hierarchy is consistent (replace the token "### Changelog" with "##
Changelog" in the README.md).
- Line 41: Replace the legacy pub.dartlang.org URL with the canonical pub.dev
URL in the README: update the markdown link and badge target that currently
point to "https://pub.dartlang.org/packages/stream_chat_localizations" to
"https://pub.dev/packages/stream_chat_localizations" (and ensure the badge
image/link references use pub.dev instead of pub.dartlang.org).

In `@packages/stream_chat_persistence/README.md`:
- Line 76: Replace the ambiguous link text "here" with a descriptive label to
improve accessibility and scanability; update the README sentence that mentions
"sql-wasm.js" and "sql-wasm.wasm" so the link text reads something like "sql.js
releases" (e.g., "You can grab the latest version of `sql-wasm.js` and
`sql-wasm.wasm` from the sql.js releases and copy them into your `/web`
folder.") so the anchor clearly describes the destination.
- Line 15: Update the Markdown heading "### Changelog" to use a level-2 heading
"## Changelog" so the document's heading hierarchy is consistent; locate the
heading string "### Changelog" in README.md and replace it with "## Changelog".

In `@packages/stream_chat/README.md`:
- Line 15: The Changelog heading uses "### Changelog" which skips a level;
update the markdown heading to "## Changelog" so the document heading hierarchy
is correct and sequential (replace the "### Changelog" line in the README with
"## Changelog").

In `@README.md`:
- Line 3: The hero image markdown lacks alt text; update the image tag that
references
https://raw.githubusercontent.com/GetStream/stream-chat-flutter/master/images/sdk_hero_v10.png
to include a descriptive alt string (e.g. change
![](https://raw.../sdk_hero_v10.png) to something like ![Stream Chat Flutter SDK
hero image](https://raw.../sdk_hero_v10.png)), ensuring the alt text succinctly
describes the image for accessibility and to satisfy MD045.
- Line 124: The README link labeled "versioning policy documentation" currently
points to the Flutter SDK installation path; update the href so the label and
target match by replacing the URL
"https://getstream.io/chat/docs/sdk/flutter/basics/installation/" with the
actual versioning policy page URL (or alternatively change the link text to
"installation" if you prefer to keep the current target) so the sentence's link
target aligns with the label.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 916e58cc-6f7d-4d88-b2a1-ee9e43b75c64

📥 Commits

Reviewing files that changed from the base of the PR and between cd831af and 099c3cf.

⛔ Files ignored due to path filters (2)
  • images/sdk_hero_v10.png is excluded by !**/*.png
  • images/sdk_hero_v4.png is excluded by !**/*.png
📒 Files selected for processing (7)
  • README.md
  • packages/stream_chat/README.md
  • packages/stream_chat_flutter/README.md
  • packages/stream_chat_flutter_core/README.md
  • packages/stream_chat_localizations/README.md
  • packages/stream_chat_persistence/README.md
  • sample_app/README.md

Comment thread packages/stream_chat_flutter_core/README.md Outdated
Comment thread packages/stream_chat_flutter_core/README.md Outdated
Comment thread packages/stream_chat_flutter/README.md Outdated
Comment thread packages/stream_chat_flutter/README.md Outdated
Comment thread packages/stream_chat_localizations/README.md Outdated
Comment thread packages/stream_chat_persistence/README.md Outdated
Comment thread packages/stream_chat_persistence/README.md Outdated
Comment thread packages/stream_chat/README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
@renefloor renefloor force-pushed the docs/update-readmes branch from 7e3e3b1 to 359c8dd Compare June 9, 2026 09:38
@renefloor renefloor changed the title update sdk readmes docs(ui,llc): update sdk readmes Jun 9, 2026
@renefloor renefloor merged commit fd6035a into v10.0.0 Jun 9, 2026
15 of 19 checks passed
@renefloor renefloor deleted the docs/update-readmes branch June 9, 2026 09:59
@xsahil03x xsahil03x mentioned this pull request Jun 9, 2026
10 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants