Deprecate Polaris-react (#14109)

## Summary

* Adds new deprecation information to README.md, indicating deprecation.
* Updates polaris-react.shopify.com to include a link to the released
(as of merge) Polaris Web Component documentation.
* Updates hero section to include deprecation notice, removes call to
action


<img width="1270" height="818" alt="Screenshot 2025-09-30 at 6 58 42 AM"
src="https://github.com/user-attachments/assets/39366a99-37d9-4cae-8d7d-40ca0f242bdc"
/>

---------

Co-authored-by: Kyle Durand <[email protected]>

Author: Aubron

.changeset/tall-doors-attend.md

@@ -0,0 +1,2 @@
+---
+---

README.md

@@ -1,17 +1,19 @@
-<div align="center">
-  <a href="https://polaris.shopify.com">
-    <img
-      src="https://github.com/Shopify/polaris/blob/main/documentation/readme.png?raw=true"
-      alt=""
-    />
-  </a>
-</div>
+# Polaris React (⚠️ Deprecated)
 
-# Polaris React
+[![storybook](https://shields.io/badge/storybook-grey?logo=storybook&style=flat)](https://storybook.polaris.shopify.dev) [![npm version](https://img.shields.io/npm/v/@shopify/polaris.svg?label=@shopify/polaris)](https://www.npmjs.com/package/@shopify/polaris) [![CI](https://github.com/shopify/polaris/workflows/CI/badge.svg)](https://github.com/Shopify/polaris/actions?query=branch%3Amain)
 
-> Build. Contribute. Evolve. Shape the merchant experience for Shopify’s core product, the admin.
+The **Shopify Polaris React library** is deprecated.  
+We are no longer accepting contributions or feature requests in this repository.
+
+On October 1, 2025, we released our [Polaris Web Components](https://shopify.dev/docs/api/app-home/polaris-web-components) for Shopify app development. We encourage Shopify App developers to adopt Polaris Web Components for new development.
+
+This repository will remain available for historical purposes, but it will not receive updates or maintenance.
+
+## Why Web Components?
+
+Polaris Web Components provide a more **technology-agnostic foundation**.  
+They are framework-independent and can be used in **React, Vue, Next.js, plain JavaScript, or even server-rendered stacks like Rails or PHP**. This enables more Shopify App developers across more platforms to use Polaris.
 
-[![storybook](https://shields.io/badge/storybook-grey?logo=storybook&style=flat)](https://storybook.polaris.shopify.dev) [![npm version](https://img.shields.io/npm/v/@shopify/polaris.svg?label=@shopify/polaris)](https://www.npmjs.com/package/@shopify/polaris) [![CI](https://github.com/shopify/polaris/workflows/CI/badge.svg)](https://github.com/Shopify/polaris/actions?query=branch%3Amain) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Shopify/polaris/blob/main/.github/CONTRIBUTING.md#your-first-pull-request)
 
 ## About this repo
 

polaris.shopify.com/src/components/Frame/Frame.tsx

@@ -96,10 +96,10 @@ function Frame({darkMode, children}: Props) {
     <>
       <div className={styles.PolarisUnifiedCta}>
         <div>
-          <a href="https://shopify.dev/beta/next-gen-dev-platform/polaris">
+          <a href="https://shopify.dev/docs/api/app-home/polaris-web-components">
             {icons.Polaris()}
-            <strong>Introducing Polaris</strong> - Unified and for the web.{' '}
-            <span className={styles.ReleaseCandidate}>Release Candidate</span>
+            <strong>Introducing Polaris Web Components</strong>{' '}
+            <span className={styles.ReleaseCandidate}>Now Released</span>
             <Icon source={ArrowRightIcon} />
           </a>
         </div>

polaris.shopify.com/src/components/HomePage/HomePage.tsx

@@ -10,15 +10,13 @@ function HomePage({}: Props) {
     <Page>
       <div className={styles.HomePage}>
         <PageMeta description="A starter kit for reimagining commerce." />
-
         <div className={styles.Hero}>
           <div className={styles.Text}>
             <h1>
-              <span>Build.</span> <span>Contribute.</span> <span>Evolve.</span>
+              <span>Polaris</span> <span>Design System</span> <span>for React</span>
             </h1>
             <p>
-              Shape the merchant experience for Shopify’s core product, the
-              admin.
+              (Deprecated)
             </p>
           </div>
         </div>