---
title: Shop Minis
description: Build fast.
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis'
  md: 'https://shopify.dev/docs/api/shop-minis.md'
api_name: shop-minis
---

# 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](https://shop.com).

## Introduction

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

* Fast and responsive
* Easy to develop and maintain
* Secure and reliable

***

## Requirements

* [Node.js](https://nodejs.org/en/download/) version 20 or higher
* [XCode](https://developer.apple.com/xcode/) or [Android Studio](https://developer.android.com/studio)

***

## Setup

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

## Create a new project

```sh
npm init @shopify/shop-mini@latest
```

***

## Development

Use the [`dev`](https://shopify.dev/docs/api/shop-minis/commands/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 →](https://shopify.dev/docs/api/shop-minis/deeplinks)
* Press `q` to scan a QR code to open on a physical iOS device.

[Command - Learn more about the dev command](https://shopify.dev/docs/api/shop-minis/commands/dev)

[Guide - Testing deeplinks](https://shopify.dev/docs/api/shop-minis/deeplinks)

## Start the development server

```sh
npx shop-minis dev
```

***

## Permissions

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](https://www.shopify.com/partners).
2. Open the page for the team member who needs access.
3. Under **Sensitive permissions**, enable **Manage apps**.
4. 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.

***

## Coding 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.

[Guide - Learn how coding assistants help you build](https://shopify.dev/docs/api/shop-minis/coding-assistant-support)

***

## Debugging (i​OS)

During development in an iOS simulator, you can use Safari Web Inspector to debug your Shop Mini. See [this documentation](https://developer.apple.com/library/archive/documentation/NetworkingInternetWeb/Conceptual/Web_Inspector_Tutorial/EnableWebInspector/EnableWebInspector.html) on how to enable Web Inspector.

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

***

## Debugging (Android)

During development in an Android emulator or device, you can use Chrome DevTools to debug your Shop Mini. See [this documentation](https://developer.chrome.com/docs/devtools/remote-debugging) on how to use Chrome DevTools remote debugging.

[Guide - Troubleshooting guide](https://shopify.dev/docs/api/shop-minis/troubleshooting)

***

## Get Support

Join the [Shop Minis forum](https://community.shopify.dev/c/shop-minis/33) 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!

***