Shopify Development Expert

Purpose

Provide comprehensive, accurate guidance for building on Shopify's platform based on 24+ official documentation files. Cover all aspects of app development, theme customization, API integration, checkout extensions, and e-commerce features.

Documentation Coverage

Full access to official Shopify documentation (when available):

• Location: docs/shopify/
• Files: 25 markdown files
• Coverage: Complete API reference, guides, best practices, and implementation patterns

Note: Documentation must be pulled separately:

pipx install docpull
docpull https://shopify.dev/docs -o .claude/skills/shopify/docs

Major Areas:

• GraphQL Admin API (products, orders, customers, inventory)
• Storefront API (cart, checkout, customer accounts)
• REST Admin API (legacy support)
• App development (authentication, webhooks, extensions)
• Theme development (Liquid, sections, blocks)
• Headless commerce (Hydrogen, Oxygen)
• Checkout customization (UI extensions, validation)
• Shopify Functions (discounts, delivery, payments)
• POS extensions (in-person sales)
• Subscriptions and selling plans
• Metafields and custom data
• Shopify Flow automation
• CLI and development tools
• Privacy and compliance
• Performance optimization

When to Use

Invoke when user mentions:

• Platform: Shopify, e-commerce, online store, merchant
• APIs: GraphQL, REST, Storefront API, Admin API
• Products: product management, collections, variants, inventory
• Orders: order processing, fulfillment, shipping
• Customers: customer data, accounts, authentication
• Checkout: checkout customization, payment methods, delivery options
• Themes: Liquid templates, theme development, sections, blocks
• Apps: app development, extensions, webhooks, OAuth
• Headless: Hydrogen, React, headless commerce, Oxygen
• Functions: Shopify Functions, custom logic, discounts
• Subscriptions: recurring billing, selling plans, subscriptions
• Tools: Shopify CLI, development workflow
• POS: point of sale, retail, in-person payments

How to Use Documentation

When answering questions:

1. Search for specific topics:

   # Use Grep to find relevant docs
   grep -r "checkout" .claude/skills/shopify/docs/ --include="*.md"
   

2. Read specific documentation:

   # API docs
   cat .claude/skills/shopify/docs/shopify/api-admin-graphql.md
   cat .claude/skills/shopify/docs/shopify/api-storefront.md
   

3. Find implementation guides:

   # List all guides
   ls .claude/skills/shopify/docs/shopify/
   

Core Authentication

OAuth 2.0 Flow

// Redirect to Shopify OAuth
const authUrl = `https://${shop}/admin/oauth/authorize?` +
  `client_id=${process.env.SHOPIFY_API_KEY}&` +
  `scope=read_products,write_products&` +
  `redirect_uri=${redirectUri}&` +
  `state=${nonce}`;

// Exchange code for access token
const response = await fetch(
  `https://${shop}/admin/oauth/access_token`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_id: process.env.SHOPIFY_API_KEY,
      client_secret: process.env.SHOPIFY_API_SECRET,
      code
    })
  }
);

const { access_token } = await response.json();

Session Tokens (Modern Embedded Apps)

import { shopifyApi } from '@shopify/shopify-api';

const shopify = shopifyApi({
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecretKey: process.env.SHOPIFY_API_SECRET,
  scopes: ['read_products', 'write_products'],
  hostName: process.env.HOST,
  isEmbeddedApp: true,
});

GraphQL Admin API

Query Products

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        handle
        priceRange {
          minVariantPrice {
            amount
            currencyCode
          }
        }
        variants(first: 5) {
          edges {
            node {
              id
              sku
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

Create Product

mutation {
  productCreate(input: {
    title: "New Product"
    vendor: "My Store"
    productType: "Apparel"
    variants: [{
      price: "29.99"
      sku: "PROD-001"
    }]
  }) {
    product {
      id
      title
    }
    userErrors {
      field
      message
    }
  }
}

Fetch Orders

query {
  orders(first: 25, query: "fulfillment_status:unfulfilled") {
    edges {
      node {
        id
        name
        createdAt
        totalPriceSet {
          shopMoney {
            amount
            currencyCode
          }
        }
        customer {
          email
        }
        lineItems(first: 10) {
          edges {
            node {
              title
              quantity
            }
          }
        }
      }
    }
  }
}

Storefront API

Create Cart

mutation {
  cartCreate(input: {
    lines: [{
      merchandiseId: "gid://shopify/ProductVariant/123"
      quantity: 1
    }]
  }) {