Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

Co-authored-by: Chloe Rice <>
Co-authored-by: Sophie Schneider <>

Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Feb 15, 2022
May 24, 2022


Build. Contribute. Evolve. Shape the merchant experience for Shopify’s core product, the admin.

storybook npm version CI PRs Welcome

Status Owner Help
Active @shopify/polaris New issue

About this repo

The shopify/polaris repository is an intergalactic monorepo made up of NPM packages, VSCode extensions, and websites.

├── 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
├──         # Documentation website
└── stylelint-polaris           # Rules for custom property usage and mainline coverage


Install dependencies and build workspaces

yarn && yarn build

Run a command

One workspace

Run commands from a selected workspace using turbo run <command> --filter=<workspace>... flag.

Command Runs
yarn turbo run dev --filter=@shopify/polaris Open the react component storybook
yarn turbo run dev Open NextJS site

All workspaces

Run commands across all workspaces. This uses turbo run <command>.

Command Runs
yarn changeset Adds a new changelog entry
yarn lint Lints all workspaces
yarn test Tests all workspaces
yarn type-check Build types and check for type errors
yarn clean Remove generated files
yarn format Format files with prettier

Contribute to this repo

Pull requests are welcome. See the contribution guidelines for more information.


Source code is under a custom license based on MIT. The license restricts Polaris usage to applications that integrate or interoperate with Shopify software or services, with additional restrictions for external, stand-alone applications.

All icons and images are licensed under the Polaris Design Guidelines License Agreement