---
title: Shop Minis
description: >
  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.app).  > Beta: > The Shop Minis SDK is not yet generally
  available. Currently, access is limited to developers participating in an
  invitation-only early access program. To request entry into the early access
  program, [submit a request](https://forms.gle/suzhck1vd3WyWdx48).
api_name: shop-minis
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis'
  md: 'https://shopify.dev/docs/api/shop-minis.md'
---

# 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.app).

Beta

The Shop Minis SDK is not yet generally available. Currently, access is limited to developers participating in an invitation-only early access program. To request entry into the early access program, [submit a request](https://forms.gle/suzhck1vd3WyWdx48).

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

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

***

## Development

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

[Command - Learn more about the dev command](./shop-minis/commands/dev)

[Guide - Testing deeplinks](./shop-minis/deeplinks)

## Start the development server

```bash
npx shop-minis dev
```

***

## 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](./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](./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!

***