---
title: setup
description: >-
  Set up a new Mini.

  > Note: Run this after creating a project with `create` or when joining an
  existing Mini project. This registers your Mini with Shopify Partners, links
  it to your organization, generates API keys, and saves them to your .env file.
  Required before you can submit your Mini for review.
api_name: shop-minis
source_url:
  html: 'https://shopify.dev/docs/api/shop-minis/commands/setup'
  md: 'https://shopify.dev/docs/api/shop-minis/commands/setup.md'
---

# setup

Set up a new Mini.

**Note:** Run this after creating a project with \<code>create\</code> or when joining an existing Mini project. This registers your Mini with Shopify Partners, links it to your organization, generates API keys, and saves them to your .env file. Required before you can submit your Mini for review.

## Options

* **--regenerate-key**

  **boolean**

  Regenerate the API key for an existing Mini and update the .env file.

Examples

### Examples

* #### Usage

  ##### Default

  ```zsh
  npx shop-minis setup [options]
  ```