Shopify Polaris Design

What it does

This skill generates Shopify Polaris UI components and code snippets based on descriptions, helping developers build themes that adhere to Shopify's design system. It ensures interfaces have a native, accessible, and professional look and feel for merchants by leveraging pre-built components and following established Shopify patterns. The skill emphasizes using semantic components over custom implementations to maintain accessibility and predictability within the Shopify Admin interface.

When to use it

• Developing new Shopify themes or apps.
• Creating user interfaces that need to integrate seamlessly with the Shopify Admin.
• Ensuring a consistent design language across your Shopify development projects.
• Building settings pages for Shopify apps using Layout.AnnotatedSection.
• Displaying lists of data (products, orders) using IndexTable or LegacyCard + ResourceList.

Key capabilities

• Generates code snippets for Polaris UI components like Page, Layout, Card, and IndexTable.
• Enforces adherence to Shopify's design principles: Merchant-Focused, Native Feel, Accessibility, Predictability.
• Promotes the use of semantic HTML elements (e.g., <Text as="h2">) for typography control.
• Provides guidance on form design using FormLayout, TextField, and ContextualSaveBar.
• Encourages reliance on Polaris props for styling instead of custom CSS.

Example prompts

• "Generate a Page component with the title 'Products' and an action to add a new product."
• "Create a Card using BlockStack to display product information."
• "Show me how to implement a ContextualSaveBar for a form."

Tips & gotchas

• This skill requires familiarity with @shopify/polaris, @shopify/polaris-icons, and @shopify/app-bridge-react dependencies.
• Prioritize using Polaris props for styling; avoid custom CSS whenever possible.
• Remember to wrap your Polaris apps in an <AppProvider> component.