shopify-pos_skill

Overview

This skill guides you through building Shopify POS UI extensions that embed custom functionality into the Shopify Point of Sale on iOS and Android. It explains targets, components, core APIs, and the development workflow so you can create tiles, modals, blocks, and menu actions that behave like native POS features. Use it to design performant, offline-capable integrations for retail checkout and customer workflows.

How this skill works

The skill walks through extension architecture: targets (where the UI appears), target-specific APIs (cart, customer, session, navigation, scanner, print, storage), and UI components provided by the POS UI library. It shows how to scaffold an extension, configure shopify.extension.toml, and wire components to target APIs. It covers local development, testing in the Shopify POS app, and deployment commands.

When to use it

• Add a smart-grid tile that launches a full-screen modal from the POS home screen
• Add inline product or customer blocks to show extra data on product/customer detail screens
• Add menu items or actions on order and customer screens
• Integrate barcode scanning, receipt printing, or custom cart modifications
• Implement offline-capable features using the Storage API

Best practices

• Prioritize performance: reduce API calls and expensive computation in critical checkout flows
• Design with native components to match POS UX and accessibility
• Handle errors and network failures gracefully with clear user feedback
• Use Storage API for data that must persist offline and sync when online
• Declare and request only required scopes for GraphQL or admin API access

Example use cases

• Loyalty tile on the home smart grid that opens a modal to view and redeem points
• Product details block that displays supplier or warranty info fetched via GraphQL
• Customer details action that launches a quick-promotions modal for targeted offers
• Order screen menu item that prints custom receipts or applies complex discounts
• Scanner-enabled inventory lookup tile that adds items to the cart from barcode scans