App Home-only Polaris updates: Modal, Page, Popover, and DropZone by sordaz00 · Pull Request #3920 · Shopify/ui-extensions

sordaz00 · 2026-02-18T14:21:24Z

Updating full page content for App Home-only polaris components.

Updates completed in World and sync'd where relevant.
Improves descriptions
Updates naming convention
Improves examples descriptions to 3-sentence structure: What this pattern helps merchants accomplish + What this specific example demonstrates beginning with "This example shows..."
Update to action-oriented titles
Removes redundant examples
Add complete examples
Removes unnecessary sections for ui extension alignment
Updates/adds best practices/limitations aligned to BFS

Relates to:
https://github.com/Shopify/shopify-dev/issues/67273
https://github.com/Shopify/shopify-dev/issues/67272
https://github.com/Shopify/shopify-dev/issues/67274
https://github.com/Shopify/shopify-dev/issues/67275

Test plan

Run yarn docs:admin to regenerate documentation
Verify changes appear correctly in shopify-dev preview
Check that component names render without code styling in prose
Confirm example descriptions are clear and follow the two-sentence pattern

mcvinci

Thanks for these updates, @sordaz00! I went pretty deep on the intros, best practices, limitations, and code examples. Let me know if you have any questions or want to chat through anything. ❤️

I didn't review the prop descriptions, as I think you might need to do another rebase of the shared.d.ts and components.d.ts files. They currently have many revisions unrelated to your changes, so we might need to clean those up first. I'm happy to review those after that!

packages/ui-extensions/src/docs/shared/components/DropZone.ts

packages/ui-extensions/src/docs/shared/components/Modal.ts

packages/ui-extensions/src/docs/shared/components/Page.ts

packages/ui-extensions/src/docs/shared/components/Popover.ts

...es/ui-extensions/src/surfaces/admin/components/DropZone/examples/upload-with-validation.html

packages/ui-extensions/src/surfaces/admin/components/Popover/Popover.ab.doc.ts

packages/ui-extensions/src/surfaces/admin/components/shared.d.ts

packages/ui-extensions/src/surfaces/admin/components.d.ts

mcvinci

Added a couple more suggestions! Your updates to examples are looking 🔥!

I noticed that the updates to field / prop descriptions for modal, page, popover, and drop zone were removed from your PR (shared.ts and components.d.ts). Are you thinking to tackle those updates in a separate PR (or maybe no further updates are necessary for prop descriptions)?

packages/ui-extensions/src/docs/shared/components/DropZone.ts

mcvinci · 2026-02-20T20:48:49Z

packages/ui-extensions/src/surfaces/admin/components/DropZone/DropZone.doc.ts

+      sectionContent: `- Set clear file type and size restrictions using the \`accept\` property
+- Use the \`droprejected\` event to display meaningful error messages when uploads fail validation
+- Consider using \`disabled\` to prevent uploads during processing`,


If we do end up keeping these here, let's just add periods at the end of each statement. 😄

mcvinci · 2026-02-20T21:10:54Z

@sordaz00 Re: CI errors, you should be able to feed the linting errors into Cursor for quick fixes. With the CLA, I think you can just re-run that check, and it should pass the next time.

mcvinci

One non-blocking thought to ponder, and can definitely be considered in a follow-up PR:

With the richer example code, should we also have richer descriptions that refer to specific props? I'm comparing to some of the API example descriptions that @SteveSill has written (example, which share a lot of context about what's going on in the code.

- Add Best practices and Limitations sections - Update descriptions with clearer language - Add complete workflow examples - Use interactive preview language for examples

- Modal: Replace repeated "The Modal component" with "This component", add link to App Window for complex workflows - Popover: Add second paragraph with link to Modal for larger interactions - DropZone: Restructure intro to lead with use cases, move technical details to second paragraph

- Rewrite descriptions to follow goal-focused pattern: user goal + specific implementation - Remove backticks from component names in Properties descriptions - Vary sentence structure to avoid repetitive phrasing

- Change PascalCase component names to lowercase (modal, page, popover, drop zone) - Remove backticks from component name references in descriptions - Keep code references (type fields, imports) unchanged

- Update name field from 'DropZone' to 'Drop zone'

- Generalize shared descriptions (remove prop-specific content) - Remove App Bridge-specific paragraph from Modal shared description - Add "Shopify" before "admin's" in Page description - Add MDN link for commandFor in Popover description - Update Events/Slots descriptions to match component pattern - Remove JSX tabs, keep HTML-only with language: 'preview' - Delete 28 unreferenced JSX example files

- Remove Usage/Useful for sections from Modal and Popover - Add periods to all bullet points for consistency - Update example descriptions with active verbs and prop references - Expand shared component descriptions with implementation details - Fix Page subCategory to match live docs URL structure - Sync prop descriptions from world Co-authored-by: Cursor <cursoragent@cursor.com>

Co-authored-by: Cursor <cursoragent@cursor.com>

Selective cherry-pick of only DropZone-related changes from uiext-polaris-modal-page-popover-dropzone branch (PR #3920). Updates shared DropZone description, improves DropZone.doc.ts examples and descriptions, removes JSX example files, and adds upload-with-validation.html example. Co-authored-by: Cursor <cursoragent@cursor.com>

Selective cherry-pick of only DropZone-related changes from uiext-polaris-modal-page-popover-dropzone branch (PR #3920). Updates shared DropZone description, improves DropZone.doc.ts examples and descriptions, removes JSX example files, and adds upload-with-validation.html example. Co-authored-by: Cursor <cursoragent@cursor.com> Remove changeset files not needed for cherry-pick branch Co-authored-by: Cursor <cursoragent@cursor.com>

@SteveSill

…#3986) * Improve example descriptions for MoneyField, PasswordField, Select, Switch, URLField Apply consistent 3-sentence pattern to all example descriptions: - Purpose statement explaining why to use this pattern - "This example shows..." describing specific implementation - "Click to interact with the preview." CTA Also corrected descriptions to accurately match example code. Fix prettier formatting errors (curly quotes) Co-authored-by: Cursor <cursoragent@cursor.com> Remove references to non-existent JSX example files Co-authored-by: Cursor <cursoragent@cursor.com> Remove JSX tabs, collapse to HTML-only examples Co-authored-by: Cursor <cursoragent@cursor.com> Remove 'Click to interact with the preview' from descriptions Co-authored-by: Cursor <cursoragent@cursor.com> Fix misplaced modifier in URLField description Co-authored-by: Cursor <cursoragent@cursor.com> Address PR feedback for component documentation Doc file updates (MoneyField, PasswordField, Select, Switch, URLField): - Replace "This example shows" with specific verbs (pairs, configures, displays, groups, etc.) - Fix awkward phrasing in descriptions - Clarify readOnly vs disabled behavior in URLField examples - Update password requirements checklist description HTML example fixes: - Use boolean attributes without ="true" (checked, disabled, required) - Fix country/region capitalization (United States, North America, etc.) - Remove contradictory value from MoneyField error example - Add submit button to Switch form-integration example - Remove unnecessary s-stack wrapper from URLField example - Change placeholder to example.com in URLField Co-authored-by: Cursor <cursoragent@cursor.com> * Improve examples for Avatar, Checkbox, ColorField, ColorPicker, and Icon Updates example documentation for Avatar, Checkbox, ColorField, ColorPicker, and Icon components: - Update all example descriptions to 3-sentence pattern - Remove 6 redundant examples to reduce noise - Fix ColorPicker default to show basic picker (no alpha) - Merge format hint into ColorField default placeholder Components: Avatar (8), Checkbox (5), ColorField (8), ColorPicker (2), Icon (8) Collapse examples to HTML-only for batch2 components - Remove JSX tabs, keep HTML with language: 'preview' for interactive previews - Remove 'Click to interact with the preview.' from all descriptions - Add missing backticks for property names and values - Delete unused .jsx example files (keep JSX-only validation examples) Address PR feedback for batch2 component docs - Fix ColorField default example: remove dead placeholder code, add label - Simplify ColorPicker and ColorField default descriptions to avoid restating component purpose - All example descriptions use active verbs consistently - All bolding has colons outside (**word**:) - Add HTML examples for Checkbox and ColorField validation states Co-authored-by: Cursor <cursoragent@cursor.com> Add empty changeset for docs-only changes Co-authored-by: Cursor <cursoragent@cursor.com> Fix "This example shows" phrases in ColorPicker.doc.ts Co-authored-by: Cursor <cursoragent@cursor.com> Fix prettier errors with apostrophes in strings Co-authored-by: Cursor <cursoragent@cursor.com> Fix prettier whitespace formatting Co-authored-by: Cursor <cursoragent@cursor.com> Restore missing JSX example files from base branch These JSX files are required for the docs build and were accidentally omitted from the branch. Restoring from origin/2026-01. Co-authored-by: Cursor <cursoragent@cursor.com> Remove JSX references from ColorField.doc.ts and delete JSX files - Update ColorField.doc.ts to use HTML-only examples with language: 'preview' - Delete all JSX example files that were accidentally restored - This completes the JSX to HTML conversion for batch 2 components Co-authored-by: Cursor <cursoragent@cursor.com> * Improve examples for Image and Thumbnail Updates example documentation for Image and Thumbnail components: Image (8 examples): - Swapped default to show simplest usage (src + alt) - Added "Combine aspect ratio and sizing" for advanced usage - Updated all descriptions to 3-sentence pattern - Action-oriented titles throughout Thumbnail (4 examples, was 5): - Added description to default example - Removed redundant "Basic usage" (identical to default) - Updated all descriptions to 3-sentence pattern - Action-oriented titles throughout Update packages/ui-extensions/src/surfaces/admin/components/Image/Image.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Image/Image.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Thumbnail/Thumbnail.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Simplify examples for Image and Thumbnail components - Collapse code examples to HTML only, removing duplicate JSX tabs - Remove "Click to interact with the preview." from all descriptions - Add backticks to property names in descriptions (srcSet, sizes, alt, etc.) - Delete unused .jsx example files Remove 'html' tab title from code blocks Update code block language to 'preview' for Image and Thumbnail Fix Events link to use correct polaris URL format Improve Image and Thumbnail examples based on PR feedback - Update basic Image example to show realistic product thumbnail with metadata - Remove redundant auto-sized image example - Clarify descriptions for objectFit and responsive images - Fix Thumbnail alt texts to follow "Image of" convention - Fix event handling example to use proper addEventListener pattern instead of React-style onLoad attribute - Add both load and error handlers to match description Address PR feedback for Image and Thumbnail docs - Replace "This example shows" with active verbs - Add periods to all bullet points - Lowercase component names in prose (image, thumbnail) - Fix Grid link to use proper URL format with API placeholders Co-authored-by: Cursor <cursoragent@cursor.com> Add empty changeset for docs-only changes Co-authored-by: Cursor <cursoragent@cursor.com> * Cherry-pick DropZone changes from PR #3920 Selective cherry-pick of only DropZone-related changes from uiext-polaris-modal-page-popover-dropzone branch (PR #3920). Updates shared DropZone description, improves DropZone.doc.ts examples and descriptions, removes JSX example files, and adds upload-with-validation.html example. Co-authored-by: Cursor <cursoragent@cursor.com> Remove changeset files not needed for cherry-pick branch Co-authored-by: Cursor <cursoragent@cursor.com> * Code examples for Button, ChoiceList, DateField, DatePicker, EmailField, NumberField, SearchField, TextArea, and TextField Update ChoiceList component code examples Update DateField component code examples Update EmailField component examples Update NumberField component examples Update SearchField component examples Update TextArea component examples Update TextField component examples Flatten examples into a single array removing default and groups (e.g. Basic Usage) Add title and descriptions for Button examples and restore basic usage example Update descriptions and titles for ChoiceList examples Update descriptions and titles for DateField examples Update titles and descriptions for DatePicker examples Update descriptions and titles for EmailField examples Update descriptions and titles for NumberField examples Update descriptions and titles for SearchField Update descriptions and titles for TextArea examples Update descriptions and titles for TExtField examples Fix linting errors Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/ChoiceList/ChoiceList.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/DatePicker/DatePicker.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Steve Silliker <steve.silliker@shopify.com> Incorporate review feedback from @SteveSill Remove jsx code examples Correct syntax for code examples to make preview and codeblock render properly * Code examples for ButtonGroup, Clickable, ClickableChip, Link, and Menu Delete redundant examples from ButtonGroup page Delete redundant examples from Clickable Delete redundant examples from ClickableChip Delete redundant code examples for Link component Delete redundant code examples and add new example for Menu component Update titles and descriptions for code examples Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/ClickableChip/ClickableChip.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/ClickableChip/ClickableChip.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Link/Link.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Link/Link.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Delete all jsx code examples for Polaris components leaving only HTML Delete image properties from default examples Revert changes to Chip component Revert changes to Chip.doc.ts Fix syntax for code examples so preview and code render properly Incorporate review feedback from @SteveSill --------- Co-authored-by: Stephanie Ordaz <stephanie.ordaz@shopify.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Tim Trevor <tim.trevor@shopify.com>

@SteveSill

…ons (#3985) * Improve example descriptions for MoneyField, PasswordField, Select, Switch, URLField Apply consistent 3-sentence pattern to all example descriptions: - Purpose statement explaining why to use this pattern - "This example shows..." describing specific implementation - "Click to interact with the preview." CTA Also corrected descriptions to accurately match example code. Fix prettier formatting errors (curly quotes) Co-authored-by: Cursor <cursoragent@cursor.com> Remove references to non-existent JSX example files Co-authored-by: Cursor <cursoragent@cursor.com> Remove JSX tabs, collapse to HTML-only examples Co-authored-by: Cursor <cursoragent@cursor.com> Remove 'Click to interact with the preview' from descriptions Co-authored-by: Cursor <cursoragent@cursor.com> Fix misplaced modifier in URLField description Co-authored-by: Cursor <cursoragent@cursor.com> Address PR feedback for component documentation Doc file updates (MoneyField, PasswordField, Select, Switch, URLField): - Replace "This example shows" with specific verbs (pairs, configures, displays, groups, etc.) - Fix awkward phrasing in descriptions - Clarify readOnly vs disabled behavior in URLField examples - Update password requirements checklist description HTML example fixes: - Use boolean attributes without ="true" (checked, disabled, required) - Fix country/region capitalization (United States, North America, etc.) - Remove contradictory value from MoneyField error example - Add submit button to Switch form-integration example - Remove unnecessary s-stack wrapper from URLField example - Change placeholder to example.com in URLField Co-authored-by: Cursor <cursoragent@cursor.com> * Improve examples for Avatar, Checkbox, ColorField, ColorPicker, and Icon Updates example documentation for Avatar, Checkbox, ColorField, ColorPicker, and Icon components: - Update all example descriptions to 3-sentence pattern - Remove 6 redundant examples to reduce noise - Fix ColorPicker default to show basic picker (no alpha) - Merge format hint into ColorField default placeholder Components: Avatar (8), Checkbox (5), ColorField (8), ColorPicker (2), Icon (8) Collapse examples to HTML-only for batch2 components - Remove JSX tabs, keep HTML with language: 'preview' for interactive previews - Remove 'Click to interact with the preview.' from all descriptions - Add missing backticks for property names and values - Delete unused .jsx example files (keep JSX-only validation examples) Address PR feedback for batch2 component docs - Fix ColorField default example: remove dead placeholder code, add label - Simplify ColorPicker and ColorField default descriptions to avoid restating component purpose - All example descriptions use active verbs consistently - All bolding has colons outside (**word**:) - Add HTML examples for Checkbox and ColorField validation states Co-authored-by: Cursor <cursoragent@cursor.com> Add empty changeset for docs-only changes Co-authored-by: Cursor <cursoragent@cursor.com> Fix "This example shows" phrases in ColorPicker.doc.ts Co-authored-by: Cursor <cursoragent@cursor.com> Fix prettier errors with apostrophes in strings Co-authored-by: Cursor <cursoragent@cursor.com> Fix prettier whitespace formatting Co-authored-by: Cursor <cursoragent@cursor.com> Restore missing JSX example files from base branch These JSX files are required for the docs build and were accidentally omitted from the branch. Restoring from origin/2026-01. Co-authored-by: Cursor <cursoragent@cursor.com> Remove JSX references from ColorField.doc.ts and delete JSX files - Update ColorField.doc.ts to use HTML-only examples with language: 'preview' - Delete all JSX example files that were accidentally restored - This completes the JSX to HTML conversion for batch 2 components Co-authored-by: Cursor <cursoragent@cursor.com> * Improve examples for Image and Thumbnail Updates example documentation for Image and Thumbnail components: Image (8 examples): - Swapped default to show simplest usage (src + alt) - Added "Combine aspect ratio and sizing" for advanced usage - Updated all descriptions to 3-sentence pattern - Action-oriented titles throughout Thumbnail (4 examples, was 5): - Added description to default example - Removed redundant "Basic usage" (identical to default) - Updated all descriptions to 3-sentence pattern - Action-oriented titles throughout Update packages/ui-extensions/src/surfaces/admin/components/Image/Image.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Image/Image.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Thumbnail/Thumbnail.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Simplify examples for Image and Thumbnail components - Collapse code examples to HTML only, removing duplicate JSX tabs - Remove "Click to interact with the preview." from all descriptions - Add backticks to property names in descriptions (srcSet, sizes, alt, etc.) - Delete unused .jsx example files Remove 'html' tab title from code blocks Update code block language to 'preview' for Image and Thumbnail Fix Events link to use correct polaris URL format Improve Image and Thumbnail examples based on PR feedback - Update basic Image example to show realistic product thumbnail with metadata - Remove redundant auto-sized image example - Clarify descriptions for objectFit and responsive images - Fix Thumbnail alt texts to follow "Image of" convention - Fix event handling example to use proper addEventListener pattern instead of React-style onLoad attribute - Add both load and error handlers to match description Address PR feedback for Image and Thumbnail docs - Replace "This example shows" with active verbs - Add periods to all bullet points - Lowercase component names in prose (image, thumbnail) - Fix Grid link to use proper URL format with API placeholders Co-authored-by: Cursor <cursoragent@cursor.com> Add empty changeset for docs-only changes Co-authored-by: Cursor <cursoragent@cursor.com> * Cherry-pick DropZone changes from PR #3920 Selective cherry-pick of only DropZone-related changes from uiext-polaris-modal-page-popover-dropzone branch (PR #3920). Updates shared DropZone description, improves DropZone.doc.ts examples and descriptions, removes JSX example files, and adds upload-with-validation.html example. Co-authored-by: Cursor <cursoragent@cursor.com> Remove changeset files not needed for cherry-pick branch Co-authored-by: Cursor <cursoragent@cursor.com> * Code examples for Button, ChoiceList, DateField, DatePicker, EmailField, NumberField, SearchField, TextArea, and TextField Update ChoiceList component code examples Update DateField component code examples Update EmailField component examples Update NumberField component examples Update SearchField component examples Update TextArea component examples Update TextField component examples Flatten examples into a single array removing default and groups (e.g. Basic Usage) Add title and descriptions for Button examples and restore basic usage example Update descriptions and titles for ChoiceList examples Update descriptions and titles for DateField examples Update titles and descriptions for DatePicker examples Update descriptions and titles for EmailField examples Update descriptions and titles for NumberField examples Update descriptions and titles for SearchField Update descriptions and titles for TextArea examples Update descriptions and titles for TExtField examples Fix linting errors Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/ChoiceList/ChoiceList.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/DatePicker/DatePicker.doc.ts Co-authored-by: Chad Carlson <chadwcarlson@users.noreply.github.com> Update packages/ui-extensions/src/surfaces/admin/components/Button/Button.doc.ts Co-authored-by: Steve Silliker <steve.silliker@shopify.com> Incorporate review feedback from @SteveSill Remove jsx code examples Correct syntax for code examples to make preview and codeblock render properly * Code examples for ButtonGroup, Clickable, ClickableChip, Link, and Menu Delete redundant examples from ButtonGroup page Delete redundant examples from Clickable Delete redundant examples from ClickableChip Delete redundant code examples for Link component Delete redundant code examples and add new example for Menu component Update titles and descriptions for code examples Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Clickable/Clickable.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/ClickableChip/ClickableChip.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/ClickableChip/ClickableChip.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Link/Link.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Update packages/ui-extensions/src/surfaces/admin/components/Link/Link.doc.ts Co-authored-by: Michelle Vinci <michelle.vinci@shopify.com> Delete all jsx code examples for Polaris components leaving only HTML Delete image properties from default examples Revert changes to Chip component Revert changes to Chip.doc.ts Fix syntax for code examples so preview and code render properly Incorporate review feedback from @SteveSill --------- Co-authored-by: Stephanie Ordaz <stephanie.ordaz@shopify.com> Co-authored-by: Cursor <cursoragent@cursor.com> Co-authored-by: Tim Trevor <tim.trevor@shopify.com>

github-actions bot added the cla-needed label Feb 18, 2026

sordaz00 force-pushed the uiext-polaris-modal-page-popover-dropzone branch from 9b1d2de to dc510fd Compare February 18, 2026 15:34

sordaz00 changed the base branch from 2026-04-rc to 2026-01 February 18, 2026 15:43

sordaz00 changed the title ~~Improve documentation for Modal, Page, Popover, and DropZone components~~ App Home-only Polaris updates: Modal, Page, Popover, and DropZone Feb 18, 2026

This comment has been minimized.

Sign in to view

mcvinci reviewed Feb 19, 2026

View reviewed changes

sordaz00 force-pushed the uiext-polaris-modal-page-popover-dropzone branch from e0dfa93 to 71747d6 Compare February 20, 2026 13:26

mcvinci approved these changes Feb 20, 2026

View reviewed changes

mcvinci reviewed Feb 20, 2026

View reviewed changes

This was referenced Feb 20, 2026

Improve examples for Avatar, Checkbox, ColorField, ColorPicker, and Icon #3926

Merged

Improve examples for components Image Thumbnail #3927

Merged

sordaz00 force-pushed the uiext-polaris-modal-page-popover-dropzone branch from 3730887 to 4b69208 Compare February 24, 2026 20:29

github-actions bot removed the cla-needed label Feb 24, 2026

sordaz00 and others added 10 commits February 24, 2026 21:32

Improve Polaris component docs: Page, DropZone, Modal, Popover

20dfee1

- Add Best practices and Limitations sections - Update descriptions with clearer language - Add complete workflow examples - Use interactive preview language for examples

Update Polaris component docs: descriptions, titles, and intros

5a83b6b

Improve example descriptions for Modal, Page, Popover, and DropZone

ad2bdcf

- Rewrite descriptions to follow goal-focused pattern: user goal + specific implementation - Remove backticks from component names in Properties descriptions - Vary sentence structure to avoid repetitive phrasing

Use lowercase component names in documentation prose

26d93f1

- Change PascalCase component names to lowercase (modal, page, popover, drop zone) - Remove backticks from component name references in descriptions - Keep code references (type fields, imports) unchanged

Change DropZone page title to sentence case

d12d584

- Update name field from 'DropZone' to 'Drop zone'

Use API_NAME/API_VERSION variables in shared docs links

3a6b07a

Add empty changeset for docs-only changes

070b24d

Co-authored-by: Cursor <cursoragent@cursor.com>

sordaz00 force-pushed the uiext-polaris-modal-page-popover-dropzone branch from 4b69208 to 070b24d Compare February 25, 2026 03:33

sordaz00 and others added 4 commits February 24, 2026 21:36

Revert unintended changes to components.d.ts

84203f9

Co-authored-by: Cursor <cursoragent@cursor.com>

Revert unintended changes to shared.d.ts

1e9389d

Co-authored-by: Cursor <cursoragent@cursor.com>

Fix prettier errors with apostrophes in strings

8304734

Co-authored-by: Cursor <cursoragent@cursor.com>

Fix prettier whitespace formatting

48e1ee4

Co-authored-by: Cursor <cursoragent@cursor.com>

sordaz00 merged commit efe9ae3 into 2026-01 Feb 25, 2026
6 checks passed

mcvinci mentioned this pull request Feb 25, 2026

[Admin UI extensions 2026-04-rc] Cherry pick component example revisions #3985

Merged

mcvinci mentioned this pull request Feb 25, 2026

[Admin UI extensions 2025-10] Cherry pick component example revisions #3986

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

App Home-only Polaris updates: Modal, Page, Popover, and DropZone#3920

App Home-only Polaris updates: Modal, Page, Popover, and DropZone#3920
sordaz00 merged 14 commits into2026-01from
uiext-polaris-modal-page-popover-dropzone

sordaz00 commented Feb 18, 2026 •

edited

Loading

Uh oh!

This comment has been minimized.

mcvinci left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mcvinci left a comment

Uh oh!

Uh oh!

mcvinci Feb 20, 2026

Uh oh!

mcvinci commented Feb 20, 2026

Uh oh!

mcvinci left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

sordaz00 commented Feb 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Test plan

Uh oh!

This comment has been minimized.

mcvinci left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mcvinci left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mcvinci Feb 20, 2026

Choose a reason for hiding this comment

Uh oh!

mcvinci commented Feb 20, 2026

Uh oh!

mcvinci left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

sordaz00 commented Feb 18, 2026 •

edited

Loading