Skip to content

CUJ index [land silently] - #13769

Open
ericwindmill wants to merge 23 commits into
mainfrom
cuj-index
Open

CUJ index [land silently]#13769
ericwindmill wants to merge 23 commits into
mainfrom
cuj-index

Conversation

@ericwindmill

@ericwindmill ericwindmill commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

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

This PR adds a CUJ index page, which is landed silently for now. This is an effort to break up the currently massive #13691

Extract generic two-column filterable index layout styles and sidebar/search
components from learning resources into reusable filterable_index.dart
and _filterable-index.scss.
Adds the canonical Critical User Journeys (CUJs) data, data model,
filterable index page components, and styling for /ai/flutter-bench/cujs.
@flutter-website-bot

flutter-website-bot commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated docs.flutter.dev site (updated for commit 34c640f):

https://flutter-docs-prod--docs-pr13769-cuj-index-ucwmiabz.web.app

@flutter-website-bot

flutter-website-bot commented Aug 20, 2026

Copy link
Copy Markdown
Collaborator

Staged preview of the updated flutter.dev site (updated for commit a4f01fb):

https://flutter-dev-230821--www-pr13769-cuj-index-eerbuymc.web.app

@ericwindmill
ericwindmill marked this pull request as ready for review August 26, 2026 18:06
@ericwindmill
ericwindmill requested review from a team and sfshaza2 as code owners August 26, 2026 18:06

@gemini-code-assist gemini-code-assist 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.

Code Review

This pull request introduces a new Critical User Journey (CUJ) index page, including a catalog of journeys, search and filter capabilities, and responsive styling. The feedback highlights several critical syntax errors where .text(...) is used instead of Text(...), which will cause compilation failures. Additionally, the reviewer pointed out potential runtime crashes related to unsafe type casting of page data and checkbox states, a potential exception from calling setState on an unmounted widget, and recommended using a more specific CSS selector for querying card elements.

Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters_sidebar.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters_sidebar.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_index.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_index.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_index.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters.dart Outdated
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters_sidebar.dart
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_index.dart
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@ericwindmill ericwindmill mentioned this pull request Aug 26, 2026
4 tasks
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@lamek
lamek self-requested a review August 26, 2026 19:35

@lamek lamek 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.

LGTM on the docs stuff. I added some fixes and suggestions. I'll leave the code review to Parker and Killian.

Page I reviewed: https://flutter-docs-prod--docs-pr13769-cuj-index-ucwmiabz.web.app/ai/flutter-bench/cujs

Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated

[FlutterBench]: /ai/flutter-bench

[critical user journey]: https://static.googleusercontent.com/media/sre.google/en//static/pdf/art-of-slos-handbook-a4.pdf

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.

Is this the correct thing to link to? I see the section on user journeys, but the PDF is mostly about SLOs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ah shoot that isn't right, I meant to return to this

Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated

@sfshaza2 sfshaza2 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.

I'm a bit confused here. I looked at the staged site and I can't find the /ai/flutter-bench page that is referred to in the PR. I know that @jesskuras's restructuring PR does have that page, so is this PR waiting for her PR to land? If so, maybe mark this as draft...

@ericwindmill

Copy link
Copy Markdown
Contributor Author

I'm a bit confused here. I looked at the staged site and I can't find the /ai/flutter-bench page that is referred to in the PR. I know that @jesskuras's restructuring PR does have that page, so is this PR waiting for her PR to land? If so, maybe mark this as draft...

The path will change depending on Jess's change's, so I'm just waiting for that PR to land to know what to update it to.

@parlough parlough left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Cool! Generally looking good to me. Some small suggestions:

Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/data/cujs.yaml Outdated
Comment thread sites/docs/src/data/cujs.yaml
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters_sidebar.dart Outdated
Comment thread sites/docs/lib/src/components/pages/cuj/cuj_filters_sidebar.dart Outdated
Comment thread sites/docs/src/data/cujs.yaml
Comment thread sites/docs/lib/_sass/pages/_cuj-index.scss
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.

5 participants