Shopify Polaris

0

Shopify’s design system to help us work together to build a great experience for all of our merchants.

Collaboration

react
typescript
design-system
shopify-polaris

Polaris

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

storybook npm version CI PRs Welcome

StatusOwnerHelp
Active@shopify/polarisNew issue

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

Commands

Install dependencies and build workspaces

pnpm install && pnpm build

Run a command

One workspace

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

CommandRuns
pnpm turbo run dev --filter=@shopify/polarisOpen the react component storybook
pnpm turbo run dev --filter=polaris.shopify.comOpen polaris.shopify.com NextJS site

All workspaces

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

CommandRuns
pnpm changesetAdds a new changelog entry
pnpm lintLints all workspaces
pnpm testTests all workspaces
pnpm type-checkBuild types and check for type errors
pnpm cleanRemove generated files
pnpm formatFormat files with prettier

Contribute to this repo

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

Licenses

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