# Merchant quickstart (/docs/start/merchant-quickstart)



Appbrew provisions a dedicated app repo for your store and hands you access. The repo arrives ready to run: dependencies are pinned and the `.env` already points at your store's app config. Access to Appbrew's shared libraries (`@gauntlet/*`, `@app-brew/*` on `npm.appbrew.tech`) is configured in the repo's `.npmrc` with a read-only token, so `pnpm install` works with no per-machine registry setup. If it returns a 401, see [Registry access](/docs/ship/registry-access).

<Callout type="info" title="No repo yet?">
  There is no self-serve or from-scratch path — see
  [Getting access](/docs/start/getting-help#getting-access): install the
  Appbrew app on your store, share the domain and GitHub usernames, and your
  repo gets provisioned.
</Callout>

## 1. Clone your repo [#1-clone-your-repo]

Clone the repo Appbrew shared with you:

```bash
git clone git@github.com:<your-org>/<your-app>.git
cd <your-app>
```

## 2. Install the toolchain and dependencies [#2-install-the-toolchain-and-dependencies]

Install [mise](/docs/start/prerequisites) first if you haven't, then:

```bash
mise install    # pinned Node, pnpm, Ruby, JDK (run `mise trust` if prompted)
pnpm install
```

If `pnpm install` returns a **401** from `npm.appbrew.tech`, the committed registry token has been rotated — see [Registry access](/docs/ship/registry-access) and ask Appbrew for a fresh one.

## 3. Run the app [#3-run-the-app]

<Tabs items="[&#x22;iOS&#x22;, &#x22;Android&#x22;]">
  <Tab value="iOS">
    ```bash
    pnpm run-ios
    ```

    Installs pods, builds, and launches on a simulator.
  </Tab>

  <Tab value="Android">
    Start an emulator from Android Studio (or connect a device), then:

    ```bash
    pnpm run-android
    ```
  </Tab>
</Tabs>

You should see your store's app boot with its real home screen, navigation, and products, all rendered from the app config served by the Appbrew backend. [Run your app](/docs/start/run-your-app) explains what the dev server does, how hot reload works, and the common first-run failures.

## Where next [#where-next]

<Cards>
  <Card title="Build a custom block" href="/docs/build/custom-blocks">
    Write a React Native block, register it, and place it on a screen from the
    Appbrew dashboard.
  </Card>

  <Card title="Set up milo" href="/docs/start/milo-setup">
    Wire Appbrew's CLI into your coding agent to work with app config and
    place blocks.
  </Card>

  <Card title="Your app repo" href="/docs/ship/your-app-repo">
    How the repo is laid out, what you own versus what Appbrew updates, and how
    releases work.
  </Card>
</Cards>