// the find
Shopify/polaris-react
Shopify's Polaris Design System - React implementation (Deprecated)
Shopify's official React component library for building Shopify admin apps, now deprecated in favor of their Web Components implementation. If you're maintaining an existing Shopify app built on React, this is what you're already using. For new projects, it's a dead end.
The design token system is genuinely well-structured — tokens are versioned separately from components, which made migrations less painful than they had any right to be. The icon set is exhaustive and consistently named (600+ SVGs with metadata). The migration guides from v3 through v11 are thorough, which matters when you're stuck upgrading a big app. Storybook coverage is solid for a library of this scale.
It's deprecated. No new features, no security patches after some point, no contributions accepted — adopting it for anything new is borrowing trouble. The license is non-standard MIT: usage is restricted to apps that integrate with Shopify, so you can't take the component patterns and use them elsewhere. The shift to Web Components means the React ecosystem around this (third-party wrappers, tooling, community recipes) will rot fast. And the monorepo is heavy — pnpm + Turborepo with a Next.js docs site makes local setup nontrivial just to look at a Button component.