polaris-compositions

Installation
CLI
npx skills add https://github.com/sarojpunde/shopify-dev-toolkit-claude-plugins --skill polaris-compositions

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 5/2/2026

Shopify Development Toolkit - Claude Code Plugins

A comprehensive Claude Code plugin marketplace for Shopify development with 16 specialized agents covering theme development, app development, and Polaris UI.

šŸŽÆ Overview

This unified marketplace provides expert agents and skills for all aspects of Shopify development:

  • Theme Development - Pure Shopify Liquid themes without framework dependencies
  • App Development - Full-stack Shopify apps with Polaris, Prisma, and GraphQL
  • Polaris UI - Complete Polaris Web Components reference and patterns

šŸ“¦ Plugin Categories

šŸŽØ Theme Development (5 Plugins)

Build Shopify themes with pure Liquid, no frameworks required.

  1. shopify-liquid-specialist - Liquid templating expert
  2. shopify-section-builder - Shopify 2.0 sections with schemas
  3. shopify-global-settings - Theme settings management
  4. shopify-snippet-library - Reusable Liquid snippets
  5. shopify-translation-manager - Multi-language support

Use for:

  • Creating sections, snippets, and templates
  • Managing theme settings and customization
  • Implementing internationalization

šŸš€ App Development (6 Plugins)

Build full-stack Shopify apps with modern tools.

  1. shopify-app-orchestrator - Multi-agent coordinator for full-stack features
  2. shopify-polaris-ui - Polaris Web Components for app UIs
  3. shopify-database-specialist - Prisma schema and migrations
  4. shopify-api-integration - Shopify Admin GraphQL API
  5. shopify-design-system - Design consistency and Polaris tokens
  6. shopify-pattern-enforcer - Codebase pattern consistency

Use for:

  • Building complete Shopify apps
  • Database design and API integration
  • Ensuring code quality and consistency

šŸŽ­ Polaris UI (5 Plugins)

Master Polaris Web Components with expert guidance.

  1. polaris-component-expert - Full component library access
  2. polaris-forms-specialist - Form components and validation
  3. polaris-layout-specialist - Page layouts and structure
  4. polaris-patterns-expert - Composition patterns and templates
  5. polaris-app-bridge-specialist - Native Shopify app integration

Use for:

  • Building Polaris-based UIs
  • Implementing common page patterns
  • Integrating with Shopify Admin

šŸ› ļø Installation

  1. Clone this repository
  2. Place in your project's directory
  3. Invoke agents by name in your Claude Code session

šŸš€ Quick Start

Theme Development

Use shopify-liquid-specialist to create a product grid section
Use shopify-section-builder to build a hero banner with schema
Use shopify-translation-manager to add multi-language support

App Development

Use shopify-app-orchestrator to implement a bulk product update feature
Use shopify-database-specialist to design the database schema
Use shopify-api-integration to create GraphQL queries

Polaris UI

Use polaris-component-expert to explain how to use badges
Use polaris-forms-specialist to create a product edit form
Use polaris-patterns-expert to build an index page with filters

šŸ“š Documentation Structure

claude-plugins/
ā”œā”€ā”€ .claude-plugin/
│   └── marketplace.json          # Unified marketplace (16 plugins)
ā”œā”€ā”€ shopify-theme-development/
│   ā”œā”€ā”€ agents/                   # 5 theme agents
│   └── skills/                   # 6 theme skills
ā”œā”€ā”€ shopify-app-development/
│   ā”œā”€ā”€ agents/                   # 6 app agents
│   ā”œā”€ā”€ skills/                   # 3 app skills
│   └── patterns/                 # Safety patterns
└── shopify-polaris/
    ā”œā”€ā”€ agents/                   # 5 Polaris agents
    └── skills/                   # 2 Polaris skills

šŸŽ“ Skills

Auto-invoked knowledge bases that activate based on task context:

Theme Development:

  • shopify-liquid-fundamentals
  • shopify-section-patterns
  • shopify-schema-design
  • shopify-snippet-library
  • shopify-i18n-basics
  • shopify-workflow-tools

App Development:

  • shopify-api-patterns
  • polaris-ui-patterns
  • database-best-practices

Polaris UI:

  • polaris-fundamentals
  • polaris-compositions

šŸ“– Learning Paths

New to Shopify Themes?

  1. Start with shopify-liquid-specialist
  2. Build sections with shopify-section-builder
  3. Add translations with shopify-translation-manager

Building Shopify Apps?

  1. Use shopify-app-orchestrator for project coordination
  2. Design database with shopify-database-specialist
  3. Integrate API with shopify-api-integration
  4. Build UI with shopify-polaris-ui

Learning Polaris?

  1. Start with polaris-component-expert for fundamentals
  2. Build forms with polaris-forms-specialist
  3. Create layouts with polaris-layout-specialist
  4. Use patterns from polaris-patterns-expert

šŸŽÆ Use Cases

Theme Development

  • Creating custom sections and snippets
  • Building product grids and filters
  • Implementing theme settings
  • Adding multi-language support
  • Following Shopify best practices

App Development

  • Full-stack feature development
  • Database schema design
  • Shopify API integration
  • Polaris UI implementation
  • Code quality and consistency

Polaris UI

  • Learning Polaris components
  • Building common page layouts
  • Implementing design system
  • App Bridge integration
  • Responsive design

šŸ”§ Tools & Technologies

Theme Development:

  • Shopify Liquid
  • Shopify 2.0 Sections & Blocks
  • JSON Schema
  • Translation Files

App Development:

  • React 19 with SSR
  • Remix Framework
  • Prisma ORM
  • Shopify Admin GraphQL API 2025-01
  • PostgreSQL/MySQL/SQLite

Polaris UI:

  • Polaris Web Components
  • Shopify App Bridge
  • Design Tokens
  • Responsive Breakpoints

šŸ¤ Contributing

Contributions welcome! Please ensure:

  • Agents follow established patterns
  • Documentation is comprehensive
  • Examples are practical and tested
  • Skills provide actionable guidance

šŸ“„ License

MIT License - See LICENSE file for details

šŸ”— Resources


Built for Claude Code | Report Issues

šŸ“Š Plugin Summary

Category Plugins Skills Patterns
Theme Development 5 6 -
App Development 6 3 1
Polaris UI 5 2 -
Total 16 11 1

All plugins work together seamlessly to provide comprehensive Shopify development support.