Skip to content

CUJ index [land silently] - #13769

Merged
ericwindmill merged 26 commits into
mainfrom
cuj-index
Sep 1, 2026
Merged

CUJ index [land silently]#13769
ericwindmill merged 26 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 260df07):

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 260df07):

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
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

@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
@ericwindmill
ericwindmill requested a review from parlough August 31, 2026 17:04

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

Thanks for those adjustments @ericwindmill!

I have some final suggestions for you to consider, but none are blocking if you need to land this or prefer to address them as part of follow up work.

Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md
Comment thread sites/docs/src/data/cujs.yaml
Comment thread sites/docs/src/data/cujs.yaml Outdated
Comment thread sites/docs/src/data/cujs.yaml
Comment thread sites/docs/src/content/ai/flutter-bench/index.md Outdated
Comment thread sites/docs/src/content/ai/flutter-bench/cujs.md
/// The developer personas a critical user journey can belong to.
///
/// [dataValue] must match the `persona` values used in `src/data/cujs.yaml`.
enum CujPersona {

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.

I'd recommend creating a section on this page or some sort of UI to describe these personas further. What they are, how they differ, perhaps an example cuj.

Comment thread sites/docs/lib/src/models/cuj_model.dart Outdated
Comment thread sites/docs/lib/src/models/cuj_model.dart Outdated
@ericwindmill
ericwindmill merged commit 29f2458 into main Sep 1, 2026
16 checks passed
@ericwindmill
ericwindmill deleted the cuj-index branch September 1, 2026 14:17
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