Skip to content

[sync] 2026/03/24#1607

Merged
AmosHuKe merged 76 commits intocfug:mainfrom
AmosHuKe:sync-20260324
Mar 26, 2026
Merged

[sync] 2026/03/24#1607
AmosHuKe merged 76 commits intocfug:mainfrom
AmosHuKe:sync-20260324

Conversation

@AmosHuKe
Copy link
Member

ref #374

LouiseHsu and others added 30 commits February 17, 2026 15:55
follow up to flutter/website#13045

## Presubmit checklist

- [ ] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [ ] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Victoria Ashworth <15619084+vashworth@users.noreply.github.com>
Also renames "User Guides" to just "Guides" as we prefer "Developers"
over "Users" and the title case is inconsistent with what we use
elsewhere.

Fixes flutter/website#13084
_Description of what this PR is changing or adding, and why:_

This corrects a weird grammatical construction ("like provided by") on
the "Architecture case study" page.

_Issues fixed by this PR (if any):_ 

- Fixes a grammatical typo/clunky phrasing.

_PRs or commits this PR depends on (if any):_

## Presubmit checklist

- [ ] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [ ] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [ ] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [ ] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.
Source url: https://docs.flutter.dev/learn/pathway/tutorial/slivers

**Page**: Flutter Docs
**Tutorial Scope**: Flutter UI 102
**Global Lesson number**: 15 - _Advanced scrolling and slivers_
**Lesson Section**: 04 - _Create Advanced scrolling for contacts_

**Problem Description**
In the first placeholder code snippet of the specified lesson section,
there is a class misnomer (`ContactsListPage`) in the given else block:

`else {
          return const ContactsListPage(listId: 0); // New, temporary
        }`

The typo results in an error in the `adaptive_layout.dart` file during
that section of the tutorial.

This commit corrects the class name to ContactListsPage, defined in the
`lib/data/screens/contacts.dart` file.
Co-authored-by: Parker Lougheed <parlough@gmail.com>
Co-authored-by: Mate Narh <96638644+spartaninzaghi@users.noreply.github.com>
As it says

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Some of these are just suggestions to consider, feel free to push back
on anything you think doesn't make sense. Thanks!
_Description of what this PR is changing or adding, and why:_

Correct grammar and phrasing in README.md.
_Issues fixed by this PR (if any):_
Multiple (but small) changes were made to the README file to make it
slightly more formal and also fix typos, grammar issues and similar.
_PRs or commits this PR depends on (if any):_
N/A
## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
…… (#13104)

## Description of what this PR is changing or adding, and why:

This PR reorganizes the **Online courses** page to improve structure and
readability.

Changes include:

* Group courses by language (English, Portuguese, German, Turkish,
Italian,
  Urdu).
* Sort courses alphabetically within each language section.
* Restore the "Flutter Crash Course" entry, which already had a defined
  reference link but was not listed.
* Preserve the existing reference-style Markdown links used by the
repository.
* Keep all URLs, titles, and author attributions unchanged.

The page previously stated that courses were listed alphabetically, but
the
ordering was inconsistent and multiple languages were mixed together.
This
update provides a predictable structure and makes future additions
easier to
maintain.

This is a documentation-only change and does not modify tooling or
behavior.

Note: The documentation site could not be executed locally due to
unrelated
compilation errors. Since this change only affects a Markdown file,
maintainers
may want to verify rendering locally.

---

## Issues fixed by this PR (if any):

None.

---

## PRs or commits this PR depends on (if any):

None.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
_Description of what this PR is changing or adding, and why:_

Fix the path of the generated bindings file in the FFI package
documentation.

The `flutter create --template=package_ffi` command generates bindings
at
`lib/native_add_bindings_generated.dart`, not
`lib/src/native_add_bindings_generated.dart`.

Verified by running the command and checking the template's
`ffigen.yaml` output configuration.

_Issues fixed by this PR (if any):_

None

_PRs or commits this PR depends on (if any):_

None

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.
_Description of what this PR is changing or adding, and why: There is a
duplicate course reference in the Turkish section. I simply removed it.

@Sfshaza I also left a comment on the PR; I don't know if there would be
a real need for a new merge for this type of fix.

PR - [#13104](flutter/website#13104)

_Issues fixed by this PR (if any):_

_PRs or commits this PR depends on (if any):_

## Presubmit checklist

- [ ] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [ ] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [ ] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [ ] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.
add new design doc

## Presubmit checklist

- [ ] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [ ] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [ ] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [ ] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Added YouTube embed for Flutter Antigravity video.

_Description of what this PR is changing or adding, and why:_ Embed
Flutter + Antigravity YouTube video

_Issues fixed by this PR (if any):_

_PRs or commits this PR depends on (if any):_

## Presubmit checklist

- [ ] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [ ] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [ ] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [ ] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Adds missing redirect from child links of `/get-started/install`, such
as `/get-started/install/windows` that were used in the past.

Fixes flutter/website#13114
Removes deprecated usesCleartextTraffic. 

Addresses: flutter/flutter#182553

## Presubmit checklist

- [X] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [X] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [X] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [X] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.
Update the Google careers link to the Flutter iOS team open headcount.
It is safe to commit your `firebase_options.dart` to Git, see
https://stackoverflow.com/a/37484053/8358501. To actually secure your
app, see [Firebase security
checklist](https://firebase.google.com/support/guides/security-checklist).

---------

Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
Adds a go link for the [Flutter Dependency Package Hosting design
document](https://docs.google.com/document/d/1EKb1VypI0ArXqwBWJKGTsiQ2WU0ruYb55JpIeKxWaDs/edit?usp=sharing).

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
Hopefully/expectedly the quickstart covers everyones general needs, so
this page is for more specific needs

_Description of what this PR is changing or adding, and why:_ n/a

_Issues fixed by this PR (if any):_ n/a

_PRs or commits this PR depends on (if any):_ n/a

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
sfshaza2 and others added 21 commits March 10, 2026 18:09
The GenUI package has been updating to 0.9 (from 0.7) and includes
breaking changes. This PR updates those docs/examples.
_Description of what this PR is changing or adding, and why: Adds a
redirect for a design document.

_Issues fixed by this PR (if any):_

_PRs or commits this PR depends on (if any):_
flutter/flutter#183382

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Initial syntax and name fixes, with larger fixes coming with Kevin's code excerpt work.

Fixes flutter/website#13162
Fixes flutter/website#13163
- Adds an accurate description to the page.
- Updates the headings to be more interesting and flow more naturally
(Please do review and provide feedback here). Also add shorter fragment
IDs to each heading.
- Wrap the youtube embeds for better styling and with a max width for
better spacing.
- Adds a next card so developers know where to go to continue their
learning journey.
- Uses code font in the video descriptions where appropriate.
- Switches to non-code version of "render objects" and similar where it
makes sense, particularly when talking about multiple instances.
- Removes some usages of "we" from the descriptions.
- Slightly cleans up and updates some copy.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
- The first challenge isn't a challenge, it's a mandatory step. Also it
mentions a `Tile` usage that doesn't exist.
- The second challenge's solution wasn't collapsed.
Referencing the WebSocket documentation
https://websocket.org/reference/websocket-api/, the correct echo server
URL is now wss://echo.websocket.org.

Fixes flutter/website#13182
Add `Accept` header and `Content-Type` header to fix fetchAlbum
returning 403 on mobile.

Fix: flutter/website#13184

_PRs or commits this PR depends on (if any):_

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Parker Lougheed <parlough@gmail.com>
Updates and fixes a few issues in the `llms.txt` file. Doesn't do a
complete overhaul, but:

- Fixes a few broken links.
- Shortens a few descriptions to avoid redundancy.
- Updates the links for the latest release
- Update some Markdown syntax usage to be more consistent.
- Adds some AI-tooling related links.

Also migrates the prompt to an agent skill with adjustments to follow
best practices and the expectations of today's tools.
## Description

Adds a `flutter.dev/go` redirect for the public [Support AGP’s Built-in
Kotlin For the Ecosystem design
doc](https://docs.google.com/document/d/1iAMVVvsHqs130hc3-49sstv7n63TgM5aUd-cqAGWHfc/edit?pli=1&tab=t.0).

This is needed so the design doc follows the Flutter design doc process
and can be referenced from the tracking issue and review discussions.

## Related Issues

- flutter/flutter#181383
- flutter/flutter#180502
- flutter/flutter#181557

## Testing

- Verified the redirect entry was added in the expected location.
- Verified the destination URL points to the public Google Doc.

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Fixes flutter/website#13175

Updates windows doc to explicitly state that the lifecycle process
function snippet belongs in a custom external window's message handler.
Fixes flutter/website#13146

Also, fixes formatting and updates guidance around static websites.
Integrates the two packages we still use from the site-shared repository
as I work towards consolidating different website related code into this
singular repository.

Contributes to flutter/website#13148
_Description of what this PR is changing or adding, and why:_

Adds a `flutter.dev/go` redirect for the public [onMapLoaded
Cross-Platform
Semantics](https://docs.google.com/document/d/1ogwmAQOjbX6UoHnsQ1sQG2P0LRU2KRBED64jnjtBpIQ/edit?usp=sharing).

This is needed so the design doc follows the Flutter design doc process
and can be referenced from the tracking issue and review discussions.

_Issues fixed by this PR (if any):_

flutter/flutter#99610

_PRs or commits this PR depends on (if any):_

flutter/packages#10714

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.
@AmosHuKe AmosHuKe marked this pull request as ready for review March 24, 2026 07:58
@AmosHuKe AmosHuKe requested a review from a team as a code owner March 24, 2026 07:58
@AmosHuKe AmosHuKe requested review from AlexV525 and chenglu and removed request for a team March 25, 2026 11:43
@AmosHuKe AmosHuKe merged commit e409f9c into cfug:main Mar 26, 2026
7 checks passed
@AmosHuKe AmosHuKe deleted the sync-20260324 branch March 26, 2026 10:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.