Skip to main content

Shop Minis

Build fast. Launch faster. Shop Minis enable you to create custom shopping experiences on mobile. With our React SDK, you can build immersive features that reach millions of shoppers instantly in the Shop app.

Anchor to IntroductionIntroduction

Shop Minis are immersive, full-screen buyer experiences within the Shop app. They're designed to be:

  • Fast and responsive.
  • Easy to develop and maintain.
  • Secure and reliable.

Anchor to RequirementsRequirements

Anchor to SetupSetup

Create a new Shop Minis project with your preferred package manager:

Anchor to DevelopmentDevelopment

Use the dev command to start the development server and run your Shop Mini locally. You can preview your Mini in an Android emulator or iOS simulator, or on a physical device.

  • Press a to open on an Android device or emulator.
  • Press i to open on an iOS simulator.
  • Press d to test deeplink navigation with a custom path. Learn more →
  • Press q to scan a QR code to open on a physical iOS device.
CommandLearn more about the dev command
GuideTesting deeplinks

Anchor to PermissionsPermissions

Developers need explicit app management permissions within their Partner organization to create, manage, or submit Shop Minis.

If you're an organization owner or admin:

  1. Go to your Partner Dashboard.
  2. Navigate to Settings → Team.
  3. Find the team member who needs access.
  4. Click on their profile to edit permissions.
  5. Under Sensitive permissions, enable Manage apps.
  6. Save changes.

If you're a team member:

Ask your organization owner or admin to grant you the Manage apps permission following the steps above.

Anchor to Coding assistant supportCoding assistant support

Shop Minis work seamlessly with coding assistants like Claude, Cursor, and Windsurf. Every project includes context files that teach these tools about Shop Mini patterns, helping them provide accurate, SDK-first suggestions tailored to mobile commerce development.

Get better code suggestions from day one - no configuration required.

GuideLearn how coding assistants help you build

Anchor to Debugging (iOS)Debugging (iOS)

During development in an iOS simulator, you can use Safari Web Inspector to debug your Shop Mini. See this documentation on how to enable Web Inspector.

After Web Inspector is enabled, you can inspect your running Shop Mini from the Develop menu in Safari.

Anchor to Debugging (Android)Debugging (Android)

During development in an Android emulator or device, you can use Chrome DevTools to debug your Shop Mini. See this documentation on how to use Chrome DevTools remote debugging.

GuideTroubleshooting guide

Anchor to Get supportGet support

Join the Shop Minis forum in the Shopify Community to:

  • Ask questions and get help from the Shop Minis team.
  • Share feedback and feature requests.
  • Connect with other Shop Minis developers.
  • Find solutions to common issues.

Our team actively monitors the forum and is ready to help you succeed in building your Mini!

Was this page helpful?