shopify-development

Shopify Development Skills Guide

Skill Overview

Shopify Development Skills provides a complete development guide for building Shopify apps, extensions, and themes, covering how to use the GraphQL Admin API, Shopify CLI, the Polaris UI component library, and the Liquid template engine.

Use Cases

1. Building Shopify Merchant Tools and Integrations

Use this skill to develop a Shopify App when you need to build back-office management tools for Shopify merchants, integrate third-party services, automate workflows, or add subscription and paid features. Suitable for merchant-side solutions such as order processing systems, inventory sync tools, and customer management platforms.

2. Customizing Checkout and Admin Interfaces

Use this skill to develop a Shopify Extension when you need to customize the checkout flow, add admin action buttons, create POS extensions, or implement dynamic discount rules. Supports multiple extension types, including checkout UI extensions, admin action extensions, POS UI extensions, and Shopify Functions.

3. Modifying Storefront Front-End Display

Use this skill to develop a Shopify Theme when you need to customize the store appearance, modify product detail pages, optimize the shopping experience, or add custom functional modules. Based on the Liquid template engine, it provides flexible control over every element on each page of the store, enabling a unique brand presentation.

Core Features

1. Shopify CLI Project Scaffolding

Provides full support for Shopify command-line tooling, including common commands such as app initialization, extension generation, and theme development. Create a new project quickly with shopify app init, generate various extension templates using shopify app generate extension, and enable rapid iteration with the local development server provided by shopify app dev.

2. GraphQL Admin API Integration

Includes validated GraphQL query patterns, supporting common operations such as product queries, order retrieval, and Metafields configuration. Provides query templates for the API version 2026-01, covering best practices like cursor-based pagination, bulk operations, and rate limit handling to help developers integrate Shopify data efficiently.

3. Extension and Theme Development Templates

Provides code examples for checkout extensions, Liquid theme templates, webhook configurations, and more. Includes practical code such as React component examples (using @shopify/ui-extensions-react/checkout), Liquid template snippets, and webhook subscription configurations that can be used directly in project development.

FAQ

What foundation is needed for Shopify development?

It’s recommended to have a solid foundation in JavaScript/TypeScript, experience with the React framework (for extension development), and knowledge of GraphQL query syntax. Theme development requires familiarity with HTML/CSS and Liquid template syntax. Backend development can use languages such as Node.js, Python, or Ruby.

How do I choose between developing an App or an Extension?

Choose an App if you need independent backend logic, database storage, or to charge merchants. Choose an Extension if you only need to modify Shopify interface elements (such as checkout pages, Admin buttons, or discount rules). You can also use both together.

How do I install and use Shopify CLI?

Install globally with npm: npm install -g @shopify/cli@latest. After installation, create a new app using shopify app init, start the development server with shopify app dev, and deploy to Shopify with shopify app deploy. Theme development uses the shopify theme init and shopify theme dev commands.

What’s the difference between Shopify GraphQL and REST APIs?

GraphQL is Shopify’s recommended modern API. It supports retrieving only the fields you need, reducing the number of requests, and providing better type safety. REST API is a traditional interface, suitable for simpler scenarios. New projects should use GraphQL; the API version 2026-01 includes the latest features.

Is Shopify Liquid difficult to learn?

Liquid is Shopify’s dedicated template language with relatively simple syntax, including basic concepts such as variable output, filters, conditional logic, and loops. For developers with front-end experience, you can usually master common usage in a few days. This skill provides complete code examples and references to best practices.

How do I test Shopify apps?

Using the Shopify CLI command shopify app dev automatically creates a tunnel and connects to your development store. It’s recommended to create a dedicated test store for development and testing. Extension development supports real-time preview; theme development can be previewed locally with shopify theme dev at localhost:9292.