README
Polaris React (⚠️ Deprecated)
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 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 work with every framework as well as plain JavaScript and server-rendered sites, enabling more Shopify App developers across more platforms to use Polaris.
About this repo
The shopify/polaris repository is an intergalactic monorepo made up of NPM packages, VSCode extensions, and websites.
polaris/
├── documentation # Documentation for working in the monorepo
├── polaris-for-vscode # VS Code extension for Polaris
├── polaris-icons # Icons for Polaris
├── polaris-react # Components for @shopify/polaris package
├── polaris-tokens # Design tokens for Polaris
├── polaris.shopify.com # Documentation website
└── stylelint-polaris # Rules for custom property usage and mainline coverage